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 tight, actionable accessibility reference that assumes Claude's competence and covers keyboard, forms, contrast, and validation concretely. Its main weaknesses are the dangling REFERENCE.md pointer and mostly attribute-level (rather than full copy-paste) examples.
Suggestions
Create the referenced REFERENCE.md (with roving tabindex / aria-activedescendant patterns) or remove the dangling reference so navigation is not broken.
Add one or two complete copy-paste-ready snippets (e.g., a labeled form field with aria-invalid + aria-describedby, or a roving tabindex nav example) to lift actionability toward fully executable.
Make the Validation workflow a short numbered sequence (run axe → fix → re-run → tab-through) so the feedback loop reads as an explicit ordered process rather than prose.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean: bullet points with exact thresholds ("Body text ≥4.5:1; large text (18.5px bold / 24px) ≥3:1") and a dense copy-paste skip-link CSS block, with no padding or explanation of concepts Claude already knows. | 5 / 5 |
Actionability | Concrete, specific guidance throughout—named tools (axe-core, axe-playwright, pa11y), exact ARIA attributes (aria-expanded, aria-required, aria-invalid, aria-describedby), and exact ratios—but most guidance is attribute/threshold-level rather than complete copy-paste snippets, with only one full code block. | 4 / 5 |
Workflow Clarity | The Validation section provides an explicit feedback loop ("fix all high/critical findings and re-run until clean") plus a manual tab-through checkpoint, but the skill is a topical reference rather than a clearly sequenced multi-step workflow, so it sits just below a full explicit-workflow score. | 4 / 5 |
Progressive Disclosure | Well under 50 lines and organized into clear sections (Contrast, Keyboard, Forms, Tables, etc.), but the single "Composite widget patterns ... in REFERENCE.md" reference points to a file that does not exist on disk, a minor navigation gap. | 4 / 5 |
Total | 17 / 20 Passed |