Content
86%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 routing skill body: a decision table, verbatim output contracts, numbered chaining patterns, and explicit anti-patterns, all with near-zero padding. The only gaps are a missing example invocation for the subagents and an unstated recovery loop after a reviewer audit.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean and dense throughout: a task-to-agent decision table, exact output-contract templates, and a one-line rule of thumb ("if you'd want the subagent's output in 1/3 the tokens, pick cavecrew"). Nothing explains concepts Claude already knows — even the "Why this exists" section is three sentences of skill-specific rationale (tool results injected verbatim into main context), not generic padding. Matches the 'every token earns its place' anchor. | 5 / 5 |
Actionability | Highly actionable for an instruction-only skill: the decision table gives exact task→agent mappings, output contracts are specified verbatim ("<path:line-range> — <change ≤10 words>" / "totals: N🔴 N🟡 N🔵 N❓"), and chaining patterns are concrete ("Spawn 2-3 `cavecrew-investigator` calls in one message (different angles: defs vs callers vs tests)"). Not 5: no example of the actual prompt/invocation text to hand a cavecrew agent, a minor gap; not 3 because the guidance is specific and executable, not pseudocode-level. | 4 / 5 |
Workflow Clarity | The main "Locate → fix → verify" chain is numbered 1-2-3 with the reviewer as an explicit audit step, and the builder contract embeds a verification checkpoint ("verified: <re-read OK | mismatch @ path:line>"). Not 5: there is no explicit recovery loop after the reviewer finds issues (the chain ends at "audits the diff") and the mismatch case has no stated retry step; not 3 because checkpoints are present and clearly sequenced, and this is not a destructive/batch skill so no cap applies. | 4 / 5 |
Progressive Disclosure | Single-file skill with no references/, scripts/, or assets/ bundle and no external files referenced; nothing that belongs in a separate file is inlined — output contracts and chaining patterns are short and needed at a glance. Sections (when to use vs alternatives, output contracts, chaining patterns, what NOT to do) are well-organized and navigable, matching the well-organized single-file case. | 5 / 5 |
Total | 18 / 20 Passed |