Content
77%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A lean, well-sequenced body with explicit validation and recovery steps — genuinely strong conciseness and workflow clarity. Its main defect is a dangling reference: the canonical checkpoint template it instructs Claude to write from is missing, which simultaneously undercuts actionability and navigation.
Suggestions
Ship the referenced ./CHECKPOINT-TEMPLATE.md (or inline the checkpoint file format into SKILL.md) so the primary "create a checkpoint" action is fully executable — the Resuming section already implies sections like In Progress, Pending Approvals, and Resume Instructions that the template should define.
Fix or remove the dangling link to CHECKPOINT-TEMPLATE.md; a broken reference in a skill with no other bundle files leaves the one detailed artifact unreachable.
Clarify the cryptic sentence "Phase boundaries that warrant a checkpoint: load the **decomposition** skill." — as written it reads as a fragment; state what to do when a phase boundary is reached and where the decomposition skill lives.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~40-line body is lean and assumes Claude's competence throughout — a trigger table, terse numbered procedures, and bare commands ("Run `git status`, `git branch` — confirm you are on correct branch") with zero padding or explanation of concepts Claude already knows. Every line instructs; matches the level-5 anchor. | 5 / 5 |
Actionability | There are concrete commands (`cat .opencastle/SESSION-CHECKPOINT.md`, `git log --oneline -20`) and specific rules ("if stale (>1 session old)", "remove rows for questions the user has since answered"), but the central instruction — "Write .opencastle/SESSION-CHECKPOINT.md from the canonical CHECKPOINT-TEMPLATE.md" — depends on a template file that is not in the bundle, so the checkpoint's canonical format is unavailable and Claude must invent it. This is a key missing detail, matching the level-3 anchor rather than level 4's "minor gaps". | 3 / 5 |
Workflow Clarity | Both workflows are clearly sequenced with explicit validation checkpoints and error recovery: "Verify: `cat .opencastle/SESSION-CHECKPOINT.md`; confirm listed files exist", branch confirmation via `git status`/`git branch`, staleness checks, and a recovery loop ("If checkpoint missing or corrupt: Rebuild from `git log --oneline -20`, tracker state"). The trigger table acts as a checklist. This matches the level-5 anchor; level 4 would imply missing some of these checkpoints, and none are absent. | 5 / 5 |
Progressive Disclosure | The body is short (<50 lines) and well-sectioned, which alone would support a high score, but its single reference — "the canonical [CHECKPOINT-TEMPLATE.md](./CHECKPOINT-TEMPLATE.md)" — points to a file that does not exist anywhere in the skill directory. The one clearly-signaled reference is therefore broken and the promised detailed material is unreachable, fitting the level-3 anchor's "references present but not clearly signaled / content that should be separate is inline" better than level 4's "minor organization gaps". | 3 / 5 |
Total | 16 / 20 Passed |