Content
86%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 lean, well-structured instruction-only skill: specific HTML/ARIA guidance, numeric WCAG checkpoints, and explicit verification with exit criteria. The only gaps are minor — a runnable axe invocation and an explicit re-verify-on-failure loop would make the workflow fully self-contained.
Suggestions
Include the actual axe invocation (e.g. the axe CLI or browser extension command) so the verification step is executable rather than just named.
Add an explicit feedback loop after verification: 'If axe still reports serious/critical issues, fix and re-run until clean' rather than leaving the retry implicit.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every line is directive — no concept explanations, no padding, no restating what Claude already knows about accessibility. The ~19-line body covers procedure, exit criteria, and a counterpart pointer with zero wasted tokens. | 5 / 5 |
Actionability | Concrete, specific guidance throughout: named elements ('<button>', '<label for>', '<a href>'), named ARIA mechanics ('aria-describedby', 'role="status"', 'alt=""'), and numeric criteria ('200% zoom and 320px width'). Falls short of the 5 anchor only in verification: 'axe (no serious or critical issues)' names the tool but gives no runnable command. | 4 / 5 |
Workflow Clarity | A clear 7-step sequence ending in an explicit verification step, reinforced by a dedicated 'Exit criteria' section ('axe is clean, and the manual keyboard checklist is recorded for every touched route'). It lacks an explicit fix-and-reverify loop (what to do when axe still reports serious issues), which keeps it below the 5 anchor. | 4 / 5 |
Progressive Disclosure | The skill is under 50 lines with no external references needed; the body is organized into clean 'Procedure', 'Exit criteria', and counterpart-pointer sections. Per the rubric's simple-skill guideline, well-organized sections alone warrant a 5, and no bundle files exist to pull in. | 5 / 5 |
Total | 18 / 20 Passed |