Content
88%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, highly actionable routing skill: exact output contracts make subagent results predictable and grep-able, chaining patterns are clearly sequenced with validation, and the anti-pattern section supplies genuine error-recovery guidance. The only slack is the 'Why this exists' section, which repeats the description's compressed-output rationale at slightly greater length than it earns.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The decision table, output contracts, and 'What NOT to do' bullets are dense and filler-free, assuming Claude's competence throughout. The 'Why this exists (the real win)' section re-explains the compressed-output point already stated in the intro paragraph and the frontmatter description — minor over-explanation that could be trimmed, matching anchor 4 rather than anchor 5's every-token-earns-its-place. | 4 / 5 |
Actionability | Guidance is fully executable: exact output contract formats ('Safe to grep with `path:\d+`', '`verified: <re-read OK | mismatch @ path:line>`'), concrete spawn patterns ('Spawn 2-3 `cavecrew-investigator` calls in one message (different angles: defs vs callers vs tests)'), and a task-to-agent decision table. Per the rubric's code_vs_instruction note, absence of code is not penalized for an instruction-only skill, and this guidance covers the common cases — anchor 5. | 5 / 5 |
Workflow Clarity | The main 'Locate → fix → verify' chain is explicitly numbered and ends with a verification step ('`cavecrew-reviewer` audits the diff'), the builder embeds a feedback contract ('verified: re-read OK | mismatch @ path:line'), and the 'What NOT to do' section adds explicit validation ('Don't accept or reject a subagent's absence claim ... without one targeted check ... Check cited line numbers are within the file'). Clear sequences with explicit validation and error recovery — anchor 5; no destructive/batch cap applies. | 5 / 5 |
Progressive Disclosure | No bundle files exist and none are needed; the ~72-line body is cleanly sectioned (when-to-use table, output contracts, chaining patterns, anti-patterns) with nothing that clearly belongs in a separate file. It sits between anchor 4 (good structure, appropriately placed) and anchor 5 (which centers on well-signaled external references); since it exceeds the under-50-line simple-skill exemption and no reference signaling applies, boundary guidance puts it at 4. | 4 / 5 |
Total | 18 / 20 Passed |