Content
85%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 tightly written operational skill: a sequenced ritual with explicit validation and revert loops, concrete commands and templates, and a clean one-level-deep reference structure that matches the actual bundle. Minor gaps only — some named-but-not-shown commands and a slightly heavy related-skills section.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and operational — "Count non-test callers exactly with `rg`", the anti-cosmetic gate, and the worktree snippet all assume Claude's competence with no filler explaining concepts Claude already knows. Not 5 because the six-link Related-skills block and the Pass-parameters section carry some tokens that could be tightened further; comfortably above 3 since there is no padded or over-explained section. | 4 / 5 |
Actionability | The git worktree block is copy-paste ready ("git fetch origin pull/<number>/head:pr-<number>-collapse"), the finding format is an exact template, and commands are named (`bun test`, `bun run typecheck`). Not 5 because key mechanics are invoked by name rather than shown — "Count non-test callers exactly with `rg`" gives no actual rg command, and the report shape is deferred to a reference. | 4 / 5 |
Workflow Clarity | The per-iteration ritual is a clear 7-step sequence with explicit validation after each edit ("`bun test` on impacted packages", "`bun run typecheck` on impacted packages"), a revert feedback loop ("If none is true, the change was cosmetic. Revert and find a deeper smell"), a re-grep straggler sweep, and explicit stop conditions. This matches anchor 5's validation-and-recovery pattern. | 5 / 5 |
Progressive Disclosure | The SKILL.md is a clear overview with a "Load on demand" References section where each of the six links (never-touch.md, smell-catalog.md, library-refusal.md, report-format.md, goal-template.md, periodic-monorepo-pass.md) names what it's for, and every referenced file actually exists in ./references/. All references are one level deep and well-signaled, matching anchor 5. | 5 / 5 |
Total | 18 / 20 Passed |