grounded-progress skill
Make Claude Fable 5 / 5.1 progress reports verifiable against actual tool results during long autonomous runs. Use for any multi-hour or overnight agent session, scheduled pipelines, CI agents, or whenever the user has been burned by status updates claiming work that wasn't done. Apply before launch, not after a fabricated report appears.
- GitHub stars
- 19
- Files
- 1
- Last commit
- Sep 2, 2026
- License
- MIT
- Allowed tools
- —
What does the grounded-progress skill do?
grounded-progress is an agent skill. Make Claude Fable 5 / 5.1 progress reports verifiable against actual tool results during long autonomous runs. Use for any multi-hour or overnight agent session, scheduled pipelines, CI agents, or whenever the user has been burned by status updates claiming work that wasn't done. Apply before launch, not after a fabricated report appears.
How to install the grounded-progress skill
Each command copies the skill folder into the client's skills directory. Restart the client or start a new session to load it.Install the grounded-progress skill in Plugin
/plugin marketplace add kpab/claude-fable-5-skills /plugin install fable5-skills@claude-fable-5-skills
Install the grounded-progress skill in Claude Code
~/.claude/skills/grounded-progress/SKILL.md
$ npx degit kpab/claude-fable-5-skills/skills/grounded-progress ~/.claude/skills/grounded-progressInstall the grounded-progress skill in Claude Code (project)
.claude/skills/grounded-progress/SKILL.md
$ npx degit kpab/claude-fable-5-skills/skills/grounded-progress .claude/skills/grounded-progressInstall the grounded-progress skill in Codex
~/.agents/skills/grounded-progress/SKILL.md
$ npx degit kpab/claude-fable-5-skills/skills/grounded-progress ~/.agents/skills/grounded-progressInstall the grounded-progress skill in Gemini CLI
~/.gemini/skills/grounded-progress/SKILL.md
$ npx degit kpab/claude-fable-5-skills/skills/grounded-progress ~/.gemini/skills/grounded-progressInstall the grounded-progress skill in Claude.ai
npx degit kpab/claude-fable-5-skills/skills/grounded-progress grounded-progress && zip -r grounded-progress.zip grounded-progress # claude.ai → Customize → Skills → + → Create skill → Upload a skill → grounded-progress.zip
SKILL.md
View on GitHubGrounded Progress
On long runs the failure mode isn't usually bad work — it's a report that drifts from the work: "tests passing" when they were never run, "deployed" when the command errored. The fix is an evidence rule applied at report time.
The evidence rule
Before any progress claim leaves your output, bind it to a tool result from this session:
- Completed → name the command/test/check whose output proves it.
- Failed → say so, and include the relevant output verbatim (trimmed, not paraphrased into optimism).
- Skipped or deferred → state it as skipped, with the reason.
- Not yet verified → label it explicitly as unverified; never round up to done.
A claim with no pointable evidence does not ship. Either produce the evidence (run the check now) or downgrade the claim.
Report shape for long runs
- One line: overall state (on track / blocked / partially done).
- Verified completions, each with its evidence pointer.
- Failures and skips, stated plainly.
- Unverified work-in-progress, labeled as such.
- The single thing needed from the user, if anything.
Anti-patterns
- Hedged completions ("should be working now") — run the check instead.
- Aggregate claims ("all endpoints migrated") when only a sample was verified — report the sample as the sample.
- Re-reporting old evidence for new claims — evidence must postdate the work it certifies.
Receiving the updates (for the harness author, not the model)
Fable 5.1 writes fewer user-facing updates between tool calls than Fable 5, most noticeably at high effort in long tool chains. The updates it does write arrive as thinking blocks, which are empty under the default thinking.display of "omitted"; request "updates" (beta header thinking-display-updates-2026-08-18) and render each non-empty thinking block as a status line before concluding the model went silent. If your UI collapses or hides tool output, tell the model so in a turn-scoped system message; otherwise it may re-run commands to "show" output nobody sees.
Files in this skill
1grounded-progress skill questions
How do I install the grounded-progress skill in Claude Code?
Run npx degit kpab/claude-fable-5-skills/skills/grounded-progress ~/.claude/skills/grounded-progress. Claude Code loads skills from ~/.claude/skills (all projects) or .claude/skills (one project) and uses a skill when its description matches the task.
Which clients can use the grounded-progress skill?
Any client that reads the Agent Skills format: Claude Code, Codex, Gemini CLI and claude.ai (upload as a ZIP). Scripts in the skill run only where the client allows code execution.