decision-journal SKILL.md skillA

decision-journal from narendawar/narens-claude-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add narendawar/narens-claude-skills/decision-journal@git:20261001.6851e1f

Pins git:20261001.6851e1f in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
narendawar/narens-claude-skills
Path
plugins/decision-journal/skills/decision-journal/SKILL.md
Versions recorded
4
Latest version
git:20261001.6851e1f, committed Oct 1, 2026
First version recorded
Oct 1, 2026
Size
4,978 bytes
Repository stars
4
License
MIT

Use when the user wants to log a prediction or estimate about a dev or project decision, grade past predictions, or see how calibrated they are (for example 'log a prediction', 'grade my predictions', 'how calibrated am I?').

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Decision Journal

## Overview

Keep a log of the user's predictions about dev and project decisions, grade them when outcomes are known, and show where they are overconfident. A script does all the writing and arithmetic so the numbers are always right; you do the conversation. It runs only when the user asks. Never log, grade, or offer to log unprompted: an offhand "this should take a few hours" is not a request.

## The script

`scripts/journal.py` in this skill's directory (use the base directory shown when the skill loads). It needs Python 3 and the standard library only. The log is `~/.claude/decision-journal.jsonl`, one JSON object per line. Commands:

- `python journal.py add --type claim --text "..." --confidence 70 [--know-by YYYY-MM-DD] [--tag a,b]`
- `python journal.py add --type estimate --text "..." --unit hours --estimate 2 [--range-low 1.5 --range-high 4] [--know-by YYYY-MM-DD] [--tag a,b]`
- `python journal.py list [--open | --due]` (prints JSON)
- `python journal.py grade ID --outcome yes|no` or `grade ID --actual NUMBER` [--note "..."] [--force]
- `python journal.py stats [--tag T]`
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add narendawar/narens-claude-skills/decision-journal@sha256:beb354c3ae330566

The line at the top of this page pins the label git:20261001.6851e1f, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_22255afuky6wderi.svg)](https://markdownregistry.com/a/art_22255afuky6wderi)

4 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 4 versions of this file, all committed on Oct 1, 2026.

versioncommittedcommitsizeaudit
git:20261001.6851e1f latest2026-10-01 6851e1f 4,978 BA view · diff
git:20261001.15ebe602026-10-01 15ebe60 4,940 BA view · diff
git:20261001.7d215e62026-10-01 7d215e6 4,724 BA view · diff
git:20261001.23c12582026-10-01 23c1258 577 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (4978 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

narendawar/narens-claude-skills · 4 stars · license MIT · pushed 2026-10-20 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_22255afuky6wderi
GET https://markdownregistry.com/api/v1/resolve?ref=narendawar/narens-claude-skills/decision-journal
GET https://markdownregistry.com/api/v1/blob/beb354c3ae330566b61dd9fb69040061f47cd66c670c85d8dee4465914f0d91c

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from narendawar/narens-claude-skills

llms.txt llms.txt file
narendawar/narens-claude-skills · llms.txt
git:20261020.8585eaa · audit A · 4 stars
comprehension-check SKILL.md skill
narendawar/narens-claude-skills · plugins/comprehension-check/skills/comprehension-check/SKILL.md · Use when the user asks to be quizzed on, or to check their understanding of, code Claude wrote this session (for…
git:20261001.15ebe60 · audit A · 4 stars
human-writing SKILL.md skill
narendawar/narens-claude-skills · plugins/human-writing/skills/human-writing/SKILL.md · Use when the user wants words written or rewritten in a human, personal voice, including short casual messages: a Slack…
git:20261020.8585eaa · audit A · 4 stars
model-bakeoff SKILL.md skill
narendawar/narens-claude-skills · plugins/model-bakeoff/skills/model-bakeoff/SKILL.md · Use when the user wants to pick the cheapest model that still works for a custom subagent, asks whether Haiku or Sonnet…
git:20261010.895cd4c · audit A · 4 stars
pdf-table-fixer SKILL.md skill
narendawar/narens-claude-skills · plugins/pdf-table-fixer/skills/pdf-table-fixer/SKILL.md · Use when the user has a tagged PDF whose tables fail accessibility checks or read badly in a screen reader (for example…
git:20261011.7b2ffe1 · audit A · 4 stars
podcast-clip-scout SKILL.md skill
narendawar/narens-claude-skills · plugins/podcast-clip-scout/skills/podcast-clip-scout/SKILL.md · Use when the user has a timestamped podcast or video transcript and wants the best short clips picked from it (for…
git:20261014.0506b44 · audit A · 4 stars
rule-promoter SKILL.md skill
narendawar/narens-claude-skills · plugins/rule-promoter/skills/rule-promoter/SKILL.md · Use when the user wants rules in CLAUDE.md enforced with hooks, says Claude keeps ignoring a CLAUDE.md rule, or asks to…
git:20261002.1c575d2 · audit A · 4 stars
schedule-doctor SKILL.md skill
narendawar/narens-claude-skills · plugins/schedule-doctor/skills/schedule-doctor/SKILL.md · Use when the user is about to schedule a Claude task, or asks why a scheduled task, /loop, cron job or routine did not…
git:20261004.a246b3f · audit A · 4 stars
subagent-tax-auditor SKILL.md skill
narendawar/narens-claude-skills · plugins/subagent-tax-auditor/skills/subagent-tax-auditor/SKILL.md · Use when the user asks why their Claude Code quota or usage limit runs out so fast, which subagents cost the most, or…
git:20261003.e9d6b70 · audit A · 4 stars
__SKILL_NAME__ SKILL.md skill
narendawar/narens-claude-skills · template/skills/__SKILL_NAME__/SKILL.md · __DESCRIPTION__
git:20261001.206faba · audit A · 4 stars

Every file in narendawar/narens-claude-skills

Other files named decision-journal

decision-journal SKILL.md skill
athola/claude-night-market · plugins/leyline/skills/decision-journal/SKILL.md · Contract for the project decision journal (tradeoffs and lessons-learned logs). Use when recording a decision…
git:20260803.38c4618 · audit A · 342 stars
decision-journal SKILL.md skill
synaptiai/synapti-marketplace · plugins/gh-workflow/skills/decision-journal/SKILL.md · Extracts and structures development decisions from diffs, manages decision journal entries, and detects human gate…
git:20260306.fe36a41 · audit A · 7 stars
decision-journal SKILL.md skill
narendawar/narens-claude-toolkit · plugins/decision-journal/skills/decision-journal/SKILL.md · Use when the user wants to log a prediction or estimate about a dev or project decision, grade past predictions, or see…
git:20261001.6851e1f · audit A · 4 stars

Browse by kind, by grade A, or by owner.