Content
93%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: tight, doctrine-dense, immediately actionable, and cleanly split across two real reference files. The only meaningful gap is validation asymmetry — generate mode has a self-audit and checklist, but the destructive compress mode and the module-map mode lack their own verification steps or retry loops.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and table-driven with zero padding: it never explains what documentation or CLAUDE.md is, assumes Claude's competence ("`ls` shows this", "The signature says this"), and every section carries skill-specific doctrine (line budgets, research statistics, anti-pattern examples). This matches 'lean and efficient; every token earns its place' — nothing here explains a concept Claude already knows. | 5 / 5 |
Actionability | For an instruction-only skill the guidance is fully concrete: exact line targets (<80/<100/<150), a fill-in-the-blank audit report template, literal commands (`ls backend/src/modules/`), binary keep/delete decision rules, and named template files to apply. This matches 'fully executable... specific examples cover the common cases'; the scoring note confirms instruction-only skills are judged on concrete guidance, which this delivers. | 5 / 5 |
Workflow Clarity | All four modes are clearly numbered and sequenced, with explicit checkpoints in the generate path (step 5 'Self-audit before delivering') and a final Quality Checklist. It falls short of score 5 because there is no fix-and-retry feedback loop and the compress mode — which destructively deletes document lines — has no post-compression validation that critical content survived, and the module-map mode has no verification step. Score 4 ('clear sequence with most checkpoints present; minor validation gaps'), not 3, because validation does exist (checklist + self-audit), so the destructive-operation cap does not apply. | 4 / 5 |
Progressive Disclosure | The ~130-line overview holds only principles and process, deferring research detail to 'references/research-foundations.md' and templates to 'references/templates.md' — both real, substantive files, referenced exactly where needed and only one level deep. This matches 'clear overview with well-signaled one-level-deep references; content appropriately split'. | 5 / 5 |
Total | 19 / 20 Passed |