Content
96%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 lean skill body: it encodes session isolation as hard, testable gates, sequences the workflow unambiguously, and delegates methodology and the quality lens to appropriately split reference files. The only structural weakness is that the verdict/severity contract lives two references deep and is duplicated across two files.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is ~24 lines with zero padding: 'Remain read-only. Never edit code, tests, plans, or state.' and 'Never bash, edit, or write.' assume Claude's competence and add only non-obvious protocol. Every token earns its place, matching anchor 5; there are no unnecessary explanations that would drop it to 4. | 5 / 5 |
Actionability | Directives are exact and executable: the tool allowlist 'tools=read,grep,find,ls', the prohibition 'Never `bash`, `edit`, or `write`', the output contract 'Return only `factory.review.v4`', and the termination step 'After the template, call `subagent_done` and emit nothing else.' This fully matches anchor 5 for an instruction-only skill — guidance is specific and unambiguous, covering the common cases (model mismatch, mutation tools present, missing packet). | 5 / 5 |
Workflow Clarity | Three clearly sequenced phases (isolate session → review the task → return the verdict), each with explicit validation checkpoints and named failure paths: 'If the model matches the work model, return `blocked`', 'If mutation tools are present, return `blocked`', 'If the packet or diff file is missing... return `blocked` and name the missing input.' Every gate has a defined recovery/report action, matching anchor 5; no validation gaps exist that would justify anchor 4. | 5 / 5 |
Progressive Disclosure | The body is a clean overview with well-signaled, purposeful references ('Read [references/reviewer-prompt.md] and follow it', 'After behavior and acceptance criteria, apply [references/code-quality.md]'), and both referenced files exist with substantive content. However, review-contract.md is only reachable two hops away via reviewer-prompt.md and is never mentioned in the body, and verdict/severity definitions are duplicated between reviewer-prompt.md and review-contract.md — minor organization gaps that keep it at anchor 4 rather than the fully one-level-deep, cleanly split structure of anchor 5. | 4 / 5 |
Total | 19 / 20 Passed |