Content
75%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, well-structured audit checklist: concrete thresholds, stable rule IDs, a specified output format, and a prioritized review order make it immediately usable. The main gaps are minor redundancy across sections, no violation/fix code examples, and no verification step for reported findings.
Suggestions
Add one bad→good code example per category (e.g., a <div onClick> next to the corrected <button>) so findings can be reported with concrete fix guidance, lifting actionability.
Deduplicate rules that appear in two sections — consolidate focus-trap/return-focus and aria-busy into single authoritative rules (A11Y-03/CP-05 and A11Y-05/CP-02 currently repeat them).
If the skill grows, split per-category detail (e.g., full A11Y or PERF guidance) into one-level-deep reference files linked from the overview sections.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is a lean, checklist-style rule set with concrete thresholds ('4.5:1 minimum', '44x44px', 'clamp(1rem, 2.5vw, 2rem)') that assumes Claude's competence and avoids explaining basics. Minor duplication keeps it below the level-5 anchor: focus-trap/return-focus appears in both A11Y-03 and CP-05, and aria-busy appears in both A11Y-05 and CP-02. | 4 / 5 |
Actionability | Rules are concrete and checkable ('Icon-only buttons MUST have aria-label', 'Use min-height: 100dvh (not 100vh)') with a fully specified output format and a worked example ('src/Button.tsx:12 — [A11Y-01] Missing aria-label on icon button'). It stops short of the level-5 anchor because there are no bad→good code examples illustrating typical violations and fixes. | 4 / 5 |
Workflow Clarity | The Review Checklist provides an explicit prioritized audit sequence ('check in this order (CRITICAL first): 1. CRITICAL: A11Y-01, A11Y-02, SEC-01...') plus a defined report format, giving a clear sequence for the audit workflow. It lacks a final verification pass over reported findings, so it matches the level-4 anchor rather than the explicit-validation level-5 anchor; the destructive/batch cap does not apply since this is a read-only audit. | 4 / 5 |
Progressive Disclosure | The document is well-organized with stable rule IDs, clear sections, and a prioritized checklist, and it is appropriately self-contained with no bundle files. At ~190 lines it exceeds the under-50-line single-file exception, and per-category detail could be split into one-level-deep reference files, placing it at the 'good structure; minor organization gaps' anchor rather than level 5. | 4 / 5 |
Total | 16 / 20 Passed |