Content
85%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.
The body is an exemplary lean rulebook: exact thresholds, concrete ARIA patterns, and a validation loop with re-run-until-clean semantics. Its one real defect is the dangling REFERENCE.md pointer — the composite-widget guidance it promises (roving tabindex, aria-activedescendant) is nowhere in the bundle, which hurts both actionability and navigation.
Suggestions
Either add the promised REFERENCE.md with the composite widget patterns (roving tabindex, aria-activedescendant) or inline the essential pattern code for menus/comboboxes/grids directly in the body.
If REFERENCE.md is not intended to exist, remove the reference and state the composite-widget rules inline so no guidance is silently missing.
Consider listing the validation tools in one place (e.g., a short Validation section note) with the exact CI invocation for axe-playwright or pa11y to make the check copy-paste ready.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every line is a rule or command with exact values ("≥4.5:1", "18.5px bold / 24px") and a copy-paste CSS block for the skip link. No conceptual padding, no explaining what WCAG or screen readers are — lean and it fully assumes Claude's competence. | 5 / 5 |
Actionability | Highly concrete: exact contrast ratios, complete skip-link CSS, specific ARIA attributes (aria-required, aria-invalid, aria-describedby, aria-expanded), a page-title format string, and named validation tools (axe-core, axe-playwright, pa11y). The gap: composite widget patterns ("roving tabindex, aria-activedescendant") are deferred to REFERENCE.md, which does not exist in the bundle, leaving that common case without executable guidance. | 4 / 5 |
Workflow Clarity | For a single-purpose standards skill, the action is unambiguous, and the Validation section provides an explicit feedback loop: "Run axe-core ... fix all high/critical findings and re-run until clean. Tab through the page to confirm order and visible focus." Not a destructive or batch operation, so no cap applies. | 5 / 5 |
Progressive Disclosure | Sections are well-organized and compact (44 lines), and the one external pointer is clearly signaled and one level deep — but "Composite widget patterns (roving tabindex, aria-activedescendant) in REFERENCE.md" references a file that is absent from the bundle. A dangling reference means the promised content is unreachable, so navigation fails despite good structure. | 3 / 5 |
Total | 17 / 20 Passed |