Content
92%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.
An exceptionally lean procedural skill: a fully sequenced lifecycle with validation gates, reviewer routing, and explicit evidence rules, delegating durable knowledge to named repo docs exactly as a SKILL.md overview should. The only gap is that key commands (probe, gates) live entirely in referenced documents rather than being shown inline.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is a dense, unpadded 10-step procedure with zero conceptual explanation — every line is an instruction or a pointer ("Write the acceptance criteria... to the gitignored .plans/<task>.md", "never to CHANGELOG.md"). It fully assumes Claude's competence and matches 'every token earns its place'; it is well above the 4 anchor, which allows minor over-explanation. | 5 / 5 |
Actionability | Guidance is largely concrete and executable: exact file paths (.plans/<task>.md, changelog.d/<branch>.md, docs/development/quality-gates.md), concrete flags (--format json --quiet), and a specific version-probing procedure. However, most commands are delegated to referenced docs rather than given inline (e.g., the actual probe command and gate commands are not shown), which fits 'mostly executable guidance; concrete code or commands with minor gaps' rather than the copy-paste-ready 5 anchor. | 4 / 5 |
Workflow Clarity | The 10 steps give a clear, ordered sequence with explicit validation checkpoints and feedback loops: a fail-first command for bugs ("get a command that fails before you change code"), "Run every applicable gate", "Resolve every block", error-recovery guidance ("after a restart, suspect the .fallow/ cache first"), and a closing evidence-verification step. This matches the 5 anchor's 'explicit validation steps; feedback loops for error recovery'. | 5 / 5 |
Progressive Disclosure | The skill is under 50 lines with no bundle files and no need for external references; it keeps itself procedural and points one level deep to clearly-named durable docs (AGENTS.md, docs/development/quality-gates.md, docs/development/review-routing.md, docs/development/task-context-map.md). Per the rubric's simple-skill guidance, well-organized sections with no nested references score 5. | 5 / 5 |
Total | 19 / 20 Passed |