Content
92%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a high-quality decision-guide skill that efficiently communicates when and how to delegate to cavecrew subagents. Its strengths are the crisp decision table, precise output contracts with parseable formats, and well-sequenced chaining patterns with built-in validation. The only notable weakness is the lack of progressive disclosure via bundle files for the individual subagent configurations, though the content is well-structured enough that this is a minor issue.
Suggestions
Consider splitting the three output contracts and their detailed formats into a referenced CONTRACTS.md file, keeping only a summary in the main SKILL.md to improve progressive disclosure.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is lean and efficient. The 'Why this exists' section borders on explanatory but earns its place by quantifying the token savings (2k vs 700 tokens), which is genuinely useful decision-making context. The table format for when-to-use is maximally dense. No padding or concept explanations Claude would already know. | 3 / 3 |
Actionability | Provides concrete output contracts with exact formats (greppable patterns like `path:\d+`), specific terminal tokens for builder errors (`too-big.`, `needs-confirm.`), and clear chaining patterns with numbered steps. The decision table gives unambiguous routing for each task type. While there's no executable code, this is an instruction/decision skill where the guidance is fully actionable. | 3 / 3 |
Workflow Clarity | The 'Chaining patterns' section provides three clearly sequenced workflows (locate→fix→verify, parallel scout, single-shot edit). The builder's output contract includes built-in validation ('verified: re-read OK | mismatch @ path:line') and explicit error states. The 'What NOT to do' section acts as guardrails against common missteps, and the locate→fix→verify chain includes a review step as validation. | 3 / 3 |
Progressive Disclosure | The content is well-organized with clear sections and a logical flow from decision table → rationale → contracts → patterns → anti-patterns. However, there are no bundle files and no references to external files for the individual subagent configurations or detailed examples. For a skill of this complexity (three subagent types with contracts), splitting subagent details into referenced files could improve navigation. | 2 / 3 |
Total | 11 / 12 Passed |