Goal ledger status
A project-local, git-tracked execution record for coding agents: crash recovery, handoff, branch isolation, and safe squash — portable across Codex, Claude Code, Antigravity, Gemini CLI, and Cline
npx -y skills add jpbaking/goal-ledger --skill goal-ledger-statusAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
Produce a strictly read-only status and handoff report for the current Goal Ledger, including phase progress, next action, blockers, Git strategy, matching Goal-ID commits, branch or baseline inconsistencies, foreign commits, and dirty crash evidence. Use when the user asks for goal status, where the work stands, what remains, or an inter-agent handoff summary. Never modify files, commits, branches, or statuses.
SKILL.md
2.1 KB, as published. Nobody here has run it
Goal Ledger — status and handoff report
This skill is strictly read-only: no status changes, log entries, commits, repairs, branch switches, or cleanup.
Read sections 1–3 of the sibling goal-ledger skill. If .goal-ledger/GOAL.md is absent, say there is no Goal Ledger and stop.
Read GOAL.md and every phase file. When Repository: yes, read the current branch, worktree status, and git log <baseline>..HEAD with trailers. Report:
Run the validator bundled with the sibling goal-ledger skill in read-only mode as scripts/validate_goal_ledger.py --root <project root>. Include its errors and warnings in the report. If Python 3 is unavailable, perform the same read-only checks manually.
Goal: <title> — <goal status>
Goal ID: <id>
Outcome: <outcome>
Strategy: <strategy>; start <starting branch>; work <work branch>
Baseline: <short SHA>
Upstreams at start: start <value>; work <value> (omit without Git)
Phases: <X> done, <Y> skipped, <Z> needs-human, <W> todo, <V> ongoing
Per phase:
- phase-NNNN <status> — <title> (<a>/<b> sub-tasks done)
Handoff: <current position>; next <next action>
Goal commits: <N>; tree <clean | DIRTY — possible interrupted work> (omit without Git)
Needs you:
- <exact blocker> (omit if none)
Warnings:
- <branch mismatch / baseline problem / upstream movement / foreign or merge commit / phase state mismatch / begin without close / published history> (omit if none)
End with one recommendation: resume with goal-ledger-resume, review for acceptance, keep the completed record, or use goal-ledger-abandon if the user explicitly wants to stop.