Content
100%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 instruction-only skill body: concise, densely actionable, with concrete detection thresholds, a clear method including reading project rule chains, an explicit report/suppress threshold, and a specific reporting format. All four sections earn their place and no external files are needed at this size.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean with zero padding: every bullet is a dense detection condition ('a touched file pushed past 1000 lines', 'more than two delegation hops', 'booleans without is, has, or should') and no concept Claude already knows is explained. This matches anchor 5 (lean and efficient, every token earns its place). | 5 / 5 |
Actionability | For an instruction-only skill, the guidance is fully actionable: concrete thresholds per smell, a concrete method ('read the sibling helpers and their comments', 'Read the AGENTS.md or CLAUDE.md chain governing the changed files'), and a specific output spec ('Quote the shape... Give a concrete reframe: what to delete, split, move, or collapse, not "consider refactoring"'). This matches anchor 5 for instruction skills with concrete, specific guidance. | 5 / 5 |
Workflow Clarity | This is a simple, single-purpose skill (a review lens) whose flow is unambiguous across Scope, Method, Threshold, and Reporting sections, so the simple-skill exception applies and workflow clarity scores 5. It is a read-only review task, so the destructive/batch validation cap does not apply, and the Threshold section supplies an explicit decision checkpoint for what to report and what to suppress. | 5 / 5 |
Progressive Disclosure | The body is under 50 lines, requires no external references, and is cleanly organized into four well-labeled sections (Scope, Method, Threshold, Reporting), which meets the guideline for simple skills to score 5 with just well-organized sections. No bundle files exist to reference, and none are needed. | 5 / 5 |
Total | 20 / 20 Passed |