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: concise, densely concrete (exact copy, dimensions, tokens, and output contract), with a well-sequenced workflow and an explicit self-check. The only improvement would be adding recovery guidance to the self-check step so failed checks have a defined remediation path.
Suggestions
Extend the self-check step with a remediation loop (e.g., 'If any check fails, adjust the tokens/layout and re-verify before emitting') to close the workflow_clarity validation gap.
Clarify where the 'active DESIGN.md (injected above)' comes from and what to do if it is absent, so step 1 does not stall when the design system is missing.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean and directive throughout — no explanation of concepts Claude already knows; every line is an instruction ('Pick a serif display token...', 'Pages are 600×860 paper-tone cards with 6px shadow...'). Nothing reads as padding, and each token earns its place. | 5 / 5 |
Actionability | Highly concrete guidance for an instruction-only skill: exact copy examples ('Eyebrow ("STYLE & FORMAT GUIDE FOR CREATORS")', '"16 PRINCIPLES OF STYLE", "38 DOS & DON'TS"'), precise layout values (600×860 cards, 6px shadow, ±0.6deg rotation), required data attributes, and a literal output-contract template with the artifact tag. Claude knows exactly what to build. | 5 / 5 |
Workflow Clarity | A clear five-step sequence (read DESIGN.md → pick topic/author → layout → write → self-check) with an explicit self-check checklist covering hierarchy, italic accent, and mono usage. It falls short of 5 because the self-check is a one-shot assertion with no feedback loop — nothing tells Claude what to do when a check fails — leaving a minor validation gap. | 4 / 5 |
Progressive Disclosure | The skill is a short, single-purpose document with no bundle files (no references/, scripts/, or assets/ exist), and it is appropriately self-contained: two well-organized sections (Workflow, Output contract) with no content that belongs in a separate file. Under the simple-skill guidance, well-organized sections with no need for external references earn the top score. | 5 / 5 |
Total | 19 / 20 Passed |