Content
57%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 a well-structured, appropriately short overview that correctly delegates detailed code examples to references/rule.md, but its own guidance is vague and redundant (Quick Reference duplicates Check, Explain teaches known basics), and no concrete role→required-attribute details or sequenced verification steps appear in the body itself.
Suggestions
Delete or merge the redundant "Quick Reference" section into "Check", and cut the generic "Explain" rationale that Claude already knows.
Inline a compact role → required-attributes table (slider → aria-valuenow/min/max, scrollbar → aria-controls/orientation/valuenow, etc.) so the core guidance is executable without opening the reference file.
Turn Check/Fix into an ordered review workflow with an explicit verification step (e.g., re-inspect the accessibility tree or re-run axe after adding attributes).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is short, but the "Quick Reference" bullets largely duplicate the "Check" section ("Ensure attributes like aria-valuenow for sliders are present" vs "Verify that all ARIA roles have their mandatory attributes"), and the "Explain" section restates screen-reader basics Claude already knows. It is mostly efficient but includes unnecessary/redundant material that could be tightened, matching the 3 anchor. | 3 / 5 |
Actionability | There is one concrete example ("aria-valuenow for role='slider'") and a clear pointer to references/rule.md with full code samples, but the body's own guidance is high-level — "Verify that all ARIA roles have their mandatory attributes as defined by the WAI-ARIA specification" gives no list of roles, required attributes, or commands to run. Some concrete guidance exists yet key executable details are missing, fitting the 3 anchor better than the minimal 2. | 3 / 5 |
Workflow Clarity | The Check → Fix → Explain → Code Review sections imply a loose review sequence, and the Code Review section at least mentions verifying "the fix with browser accessibility tooling or assistive tech", but no explicit ordered steps or validation checkpoints appear in the body (those live in the referenced file). The sequence is present with implicit checkpoints, matching the 3 anchor. | 3 / 5 |
Progressive Disclosure | The ~30-line body is a genuine overview — summary, quick reference, and check/fix/explain/review sections — with a single clearly signaled, one-level-deep pointer ("For full implementation details, code examples, and framework-specific guidance, see `references/rule.md`"), and that file exists in the bundle with no further nesting. This matches the 5 anchor: clear overview, well-signaled reference, easy navigation. | 5 / 5 |
Total | 14 / 20 Passed |