Content
82%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 concise, well-structured checklist-style skill with genuinely non-obvious domain knowledge (the axe placeholder gotcha, the 57% coverage stat) and an explicit exit-criteria validation gate. Its main defect is the dangling 'see pattern D7' reference, which points to no existing file or section and leaves the reader unable to follow it.
Suggestions
Remove the 'see pattern D7' reference or back it with a real reference file (e.g. add references/focus-patterns.md with pattern D7) — as written it points to nothing.
Add a short feedback loop after the exit criteria, e.g. 'If violations are found, fix them and re-run the scan before proceeding.'
Include one concrete example of how to run the axe-core scan (e.g. an npm/CLI snippet) to make step 1 fully executable.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and every line earns its place: the 57% axe-core stat justifies manual checks, and details like axe accepting placeholders as accessible names are non-obvious knowledge Claude would otherwise lack. No padding or re-teaching of known concepts. | 5 / 5 |
Actionability | The guidance is concrete and specific for an instruction-only skill (exact WCAG tags, named tools, specific manual checks), but 'see pattern D7' references material that does not exist in any bundle file, and there is no example of how to actually invoke axe-core. | 4 / 5 |
Workflow Clarity | A clear six-step numbered procedure is capped by an explicit 'Exit criteria' validation section ('No serious or critical axe violations, and the manual checklist is recorded per route'). It falls short of a 5 because there is no feedback loop describing what to do when violations are found. | 4 / 5 |
Progressive Disclosure | The skill is under 50 lines with well-organized sections and no external references needed, which would merit a 5, but the body references 'pattern D7' — a pointer to content that does not exist anywhere in the skill directory. | 4 / 5 |
Total | 17 / 20 Passed |