Content
82%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 well-structured, actionable skill body: exact commands, explicit safety guardrails, documented configuration, and a clear procedure with a dry-run checkpoint. The only notable issues are minor — slightly ambiguous dry-run skip conditions, small narrative padding, and a script reference that is not present in the bundle as provided.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient and assumes competence — it documents only project-specific facts (diary protocol, env vars, squash-merge rationale) rather than concepts Claude already knows. Minor narrative flourishes like "Closes the lifecycle the root AGENTS.md's first hard rule opens" and "pays a merge-reconciliation tax later" could be trimmed, so it fits 'efficient; minor instances of over-explanation' rather than the every-token-earns-its-place bar of a 5. | 4 / 5 |
Actionability | Gives copy-paste-ready commands ("sh scripts/worktree-cleanup.sh --dry-run", "sh scripts/worktree-cleanup.sh"), exact env vars with defaults, and a concrete diary-edit rule including the empty case ("or 'None.' if empty"). As an instruction-only skill whose guidance is fully executable and covers the common cases, it matches the top anchor. | 5 / 5 |
Workflow Clarity | The four-step procedure is clearly sequenced with an explicit dry-run checkpoint and error-path handling ("If the script reports the root as dirty, surface that to the operator"; stale diary row handling), so the destructive-operation cap does not apply. It falls short of a 5 because the step-2 parenthetical "skip step 1's pause if the operator invoked the skill with a clear 'clean up' intent" introduces ambiguity about when the dry-run checkpoint is mandatory, and there is no post-run verification of the diary edit. | 4 / 5 |
Progressive Disclosure | Sections are well-organized and the split is appropriate — "The git mechanics live in scripts/worktree-cleanup.sh" delegates mechanics one level deep while the SKILL.md holds policy, with a clear Cross-references section. However, no scripts/ (or references/, assets/) directory exists in the bundle, so the referenced script path is dangling as presented — a minor organization gap that keeps this at 'good structure; most content appropriately placed' rather than a 5. | 4 / 5 |
Total | 17 / 20 Passed |