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 short, single-file skill: lean and project-specific, with unambiguous structural rules for authoring and updating zines. The only minor gap is the absence of a worked example showing a real zine header or section.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and project-specific throughout ("enough to rebuild something that works the same way, not a pixel-perfect clone"; "Links point downward in the hierarchy"), with zero padding or explanations of concepts Claude already knows. Every token earns its place, matching anchor 5; anchor 4 would require minor over-explanation to trim, which is absent. | 5 / 5 |
Actionability | Concrete, executable guidance for an instruction-only skill: exact placement ("A zine is `zine.md` at the root"), the header template ("`_<name> zine — issue #N_`"), changelog entry format ("issue number + a one-line synopsis"), and explicit routing rules. It falls at anchor 4 rather than 5 only because no worked example of an actual zine section or header is shown — a minor gap against 'specific examples cover the common cases'. | 4 / 5 |
Workflow Clarity | This is a simple, single-purpose skill under 50 lines, and the single action (author/update a zine) is unambiguous: the five sections are given in order with per-section content rules, the issue-number bump rule is explicit ("bump it when you add an entry"), and placement and link-direction rules are stated flatly. Per the simple-skill exception the single unambiguous action scores 5; no destructive or batch operations exist to require validation checkpoints. | 5 / 5 |
Progressive Disclosure | The skill is under 50 lines with no need for external references, and the content is organized into clear, well-titled sections (Where zines live / The five sections / Principles). Per the simple-skill guideline this scores 5; the one cross-skill pointer ("the **create-service** skill, not zine prose") is clearly signaled rather than a buried reference. | 5 / 5 |
Total | 19 / 20 Passed |