Content
100%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
An exemplar instruction-only skill body: concise, concrete, with a clear decision workflow and clean one-level-deep reference structure that keeps the main file scannable.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence — it presents methodology (the Discoverability Rule, Grey Box, three-question test) without padding or explaining basic concepts Claude already knows, and every section earns its place. | 3 / 3 |
Actionability | Concrete, executable guidance abounds: 'target <30 lines', 'If you're past 50 lines, it's bloated. Cut ruthlessly.', explicit belongs/does-not-belong lists, and 'Never duplicate between them'; templates and examples are delegated to real reference files. | 3 / 3 |
Workflow Clarity | The decision process is unambiguous and sequenced — apply the Discoverability Rule, then the three-question test as an explicit checkpoint, then write only what fails both — which fits the simple-skill allowance for a single, clear action. | 3 / 3 |
Progressive Disclosure | Overview methodology lives inline while templates and the anti-pattern catalog are split into two real, one-level-deep references (anti-patterns.md, claude-md-guide.md), clearly signaled via a 'Deep Dives' table for easy navigation. | 3 / 3 |
Total | 12 / 12 Passed |