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: dense with non-obvious, category-specific bug patterns, concrete methods and reporting requirements, explicit thresholds that gate what to report, and zero padding or basic-concept explanations. Its structure gives an unambiguous review workflow that fits comfortably within a small single-file skill.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence — every bullet adds non-obvious, specific guidance such as "pagination that misses the final page when the total is an exact multiple of the page size" and "returning an empty array so the caller reads 'no results' instead of 'query failed'". There is no explanation of concepts Claude already knows and no padding, matching the 'every token earns its place' anchor. | 5 / 5 |
Actionability | For an instruction-only skill, the guidance is fully executable: concrete directives like "Trace boundary math with concrete values at the edges. Follow each changed return value to its callers and each mutation to its cleanup" and "enumerate every useEffect exit path and check that each mutation before return has matching cleanup", plus a Reporting section specifying the exact output (trace, wrong outcome, fix). Specific example patterns cover the common cases in each category. | 5 / 5 |
Workflow Clarity | The skill is single-purpose and under 50 lines, with an unambiguous flow: Scope (what to check) → Method (how to trace) → Threshold (what to report) → Reporting (output format). The Threshold section is an explicit validation checkpoint — "Report bugs you can trace from an input, through the branch it takes, to the line that produces the wrong result, where a normal caller will hit it" — and the Scope section functions as a checklist, satisfying the simple-skill exception. | 5 / 5 |
Progressive Disclosure | The body is roughly 30 lines, well-organized into clearly labeled sections, with no content that warrants separate reference files and no nested references. Per the rubric's guideline for skills under 50 lines with no need for external references, well-organized sections alone merit the top score; no bundle files exist to verify. | 5 / 5 |
Total | 20 / 20 Passed |