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.
A well-structured instruction skill: an actionable 4-layer framework with concrete counts and examples, a validated 9-step workflow, and clean two-file progressive disclosure verified against the actual bundle. The only weakness is minor redundancy with the reference bundle and a few rationale lines that could be trimmed.
Suggestions
Trim the Layer 1 rationale paragraph ('The "not" half is what saves writers from overshooting...') — it restates the 'Why the not Y matters' section already in references/voice-frameworks.md.
Cut the duplicate restatement after the tone table ('Voice stays consistent across all of these. Tone is what shifts.') since the section already opens with 'Voice is constant. Tone adapts to context.'
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is largely lean and instructional — counts, tables, and checklists rather than padded prose — but a few lines explain rationale Claude doesn't need or duplicate the reference bundle: "The 'not' half is what saves writers from overshooting. 'Confident' alone produces swagger..." restates voice-frameworks.md's 'Why the not Y matters' section, and "Voice stays consistent across all of these. Tone is what shifts." repeats the section's opening claim. This fits anchor 4 ('Efficient; minor instances of over-explanation that could be trimmed') — better than 3 because the padding is a handful of lines, not sections. | 4 / 5 |
Actionability | For an instruction-only skill the guidance is fully concrete: exact counts ("Pick 3 to 5 attributes", "List 8 to 15 contexts", "The floor is 15 paired examples" with a stated practical ceiling of 25), a 14-row tone-shift table, a 7-section output format, and a worked attribute-pairing list. This matches anchor 5's 'specific examples cover the common cases' — the rubric's code-vs-instruction note says executable guidance without code is not penalized. | 5 / 5 |
Workflow Clarity | The 9-step workflow is clearly sequenced with an entry-point decision (step 1 delegates to the 'Choosing a framework' section in references/voice-frameworks.md, which exists) and an explicit validation loop: step 7's stress test scores output '1 to 5 against each attribute' with failure interpretation ('anything scoring below 3... Below 3 means the doc is incomplete, not that the copy needs another pass'). This matches anchor 5 ('explicit validation steps; feedback loops'). | 5 / 5 |
Progressive Disclosure | SKILL.md is an overview of the method with exactly two one-level-deep references, both real files (references/voice-document-template.md and references/voice-frameworks.md), each clearly signaled with its purpose, plus a dedicated 'Reference files' section. Content splitting is deliberate — the template owns the content-type list ('one list to maintain rather than two that drift apart'). This matches anchor 5 ('Clear overview with well-signaled one-level-deep references; content appropriately split; easy navigation'); the inline tone table and attribute pairs are core method patterns, not misplaced reference material. | 5 / 5 |
Total | 19 / 20 Passed |