Content
93%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 exemplary decision-guide body: compact, concrete, and well-organized, with explicit output contracts and clear chaining patterns. The only meaningful gap is that error-recovery paths (what to do after the reviewer flags issues or the builder returns a failure token) are implicit rather than explicit.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and every section earns its place: a compact decision table, terse output-format contracts, one-line rules ('if you'd want the subagent's output in 1/3 the tokens, pick cavecrew'), and a short 'What NOT to do' list. Nothing explains concepts Claude already knows — even the 'Why this exists' section adds non-obvious project-specific math (2k vs ~700 tokens per delegation). | 5 / 5 |
Actionability | For an instruction-only skill the guidance is fully actionable: a task-to-agent decision table covering common cases, exact output contracts (e.g. 'verified: <re-read OK | mismatch @ path:line>'), concrete chaining patterns, and explicit failure tokens ('too-big.', 'ambiguous.'). Per the rubric's code-vs-instruction note, the absence of code is not penalized when guidance is this concrete. | 5 / 5 |
Workflow Clarity | The 'Locate → fix → verify' chain is clearly sequenced and includes real checkpoints (builder's 'verified:' field, reviewer audit in step 3). It falls short of a 5 because the recovery loop after a reviewer finding — and the retry path when the builder returns 'too-big.' or 'ambiguous.' — is implied rather than spelled out. | 4 / 5 |
Progressive Disclosure | The skill is a single ~70-line file with no bundle directories (references/, scripts/, assets/ are absent) and no content that warrants splitting; all sections are well-organized, clearly headed, and easy to navigate, which fits the simple-skill exception for well-organized single-file skills. | 5 / 5 |
Total | 19 / 20 Passed |