Content
92%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: a fully sequenced method with embedded validation loops and a completion checklist, quantified rules throughout, and a clean one-level reference bundle that exists on disk. The only improvement available is consolidating the small amount of repeated invariant statements to save tokens.
Suggestions
State the "TOTAL 0" merge gate once (e.g., in Build and audit) and reference it from the checklist to trim repeated invariant statements.
Drop Method step 13 or the first Commit rules bullet, since "Size commits by judgment" is stated verbatim in both places.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and prescriptive (prose-limit table, fenced-block table, arrow-style table) with no padding that explains concepts Claude already knows; the manual-vs-lesson sentences define the skill's own terminology. It stops short of 5 because of trimmable redundancy: the "TOTAL 0" invariant is stated four times (intro, Method step 12, Build and audit, checklist) and "Size commits by judgment" appears as both Method step 13 and again in Commit rules. | 4 / 5 |
Actionability | Fully concrete, executable guidance: exact build commands ("node --test site/test_manuals.js", "node scripts/audit_manuals.js --manual <id>"), an exact commit message format ("feat(manual/<id>): <section slug>"), quantified limits ("at most 25 words", "viewBox=\"0 0 640 H\" with H at most 760, text at least 11 units"), and required keys per fence kind. For an instruction-only skill this is copy-paste-ready and matches anchor 5. | 5 / 5 |
Workflow Clarity | A 13-step numbered Method in dependency order with an explicit validation feedback loop ("Fix every finding until the audit prints `TOTAL 0`", "Fix the text, never the limit"), a capture drift check, and a 10-item "Check before you finish" checklist. Sequence, checkpoints, feedback loop, and checklist are all present, matching anchor 5. | 5 / 5 |
Progressive Disclosure | All six referenced files (research-and-sources.md, capture-kit.md, manual-json.md, section-template.md, prose-rules.md, audit.md) exist in references/, are linked at the point of use, are one level deep, and are indexed in a "Files" section; bulky detail (audit rules, banned words, schema fields) is correctly split out. This matches anchor 5's clear-overview pattern. | 5 / 5 |
Total | 19 / 20 Passed |