Content
61%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 well-structured with genuinely executable automated-test commands, but it pads general WCAG knowledge Claude already knows and omits a re-test validation loop after fixing issues. Tightening the generic lists and adding a verify-after-fix checkpoint would meaningfully raise quality.
Suggestions
Add an explicit feedback loop: after 'Fix Issues', re-run 'npm run test:a11y' to confirm the fix passes before considering the work done.
Trim the 'Common Accessibility Requirements' and 'Manual Checks' sections to the non-obvious specifics, dropping restatements of general WCAG knowledge Claude already has.
Make the manual-checks guidance more concrete (e.g., specific keyboard sequences or expected focus order) rather than generic bullets like 'Test keyboard navigation'.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The automated-testing section is efficient, but 'Manual Checks', 'Common Accessibility Requirements', and 'Testing Tools' restate general WCAG knowledge Claude already knows ('All interactive elements must be keyboard accessible', 'Proper ARIA labels and roles'), so it is mostly efficient with some unnecessary explanation. | 3 / 5 |
Actionability | Provides concrete, copy-paste-ready commands ('npm run test:a11y -- tabs --workers 1') and names the exact component-key file, with only the manual-checks section lacking specifics — fitting mostly executable guidance with minor gaps. | 4 / 5 |
Workflow Clarity | Steps are numbered (1-5) but the fix step has no validation/re-test checkpoint; because a11y testing is a batch operation, the missing validate→fix→retry feedback loop caps this at the anchor with sequence present but checkpoints missing or implicit. | 3 / 5 |
Progressive Disclosure | Well-organized sections (When to Use, Instructions, Standards) with a single clearly-signaled one-level reference ('.cursor/rules/accessibility-standards.md'); good structure with minor organization gaps, just over the simple-skill line. | 4 / 5 |
Total | 14 / 20 Passed |