Content
71%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, token-efficient overview with clean progressive disclosure to a genuinely useful reference file. Its main weakness is actionability: the in-body Check/Fix guidance stays abstract while all concrete examples and tooling specifics are deferred to the reference.
Suggestions
Inline one concrete example in the Check section — e.g. `aria-expanded="yes"` → `aria-expanded="true"`, and `aria-labelledby="non-existent-id"` — so the check is executable without opening the reference.
Name the concrete validation tooling in the body (e.g., 'run axe or Lighthouse; inspect the accessibility pane in browser DevTools') instead of the abstract 'validate that values conform to the allowed types'.
Drop the opening sentence explaining why invalid ARIA values break assistive tech — Claude already knows this — and let the Quick Reference lead.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean (~30 lines) with well-earned Quick Reference bullets ("Avoid using 'yes/no' where 'true/false' is required"), matching 'efficient; minor instances of over-explanation that could be trimmed'. It is not 5 because the opening line ("Invalid attribute values cause ARIA properties to be ignored or misinterpreted...") explains a concept Claude already knows, and the one-line Check/Fix sections partially duplicate content one click away in references/rule.md. It is well above 3 — there is no padding or library-tour verbosity. | 4 / 5 |
Actionability | The Quick Reference gives some concrete guidance ("aria-expanded=\"true\"", "Avoid using 'yes/no' where 'true/false' is required", "Check that IDs referenced in aria-labelledby or aria-owns actually exist"), but the Check and Fix sections are abstract direction — "Validate that all ARIA attribute values conform to the allowed types" and "Correct any invalid ARIA attribute values to match the expected format" — with no tool, command, or code example in the body itself (the ✅/❌ HTML examples live only in references/rule.md). This matches 'some concrete guidance but incomplete; missing key details' rather than 4, which requires concrete code or commands in the body. | 3 / 5 |
Workflow Clarity | The Check → Fix → Explain → Code Review sections sequence the task clearly, and the Code Review section includes a verification checkpoint ("note how to verify the fix with browser accessibility tooling or assistive tech"), matching 'clear sequence with most checkpoints present; minor validation gaps'. It is not 5 because the body never says how to validate (the axe/Lighthouse/accessibility-tree steps sit in rule.md) and the verification checkpoint is a mention, not an explicit loop; it is above 3 because sequence and a validation mention are both present, and this simple review task involves no destructive or batch operations that would cap the score. | 4 / 5 |
Progressive Disclosure | The bundle matches the ideal structure: a short overview body with a clearly signaled one-level-deep reference — "For full implementation details, code examples, and framework-specific guidance, see references/rule.md" — and references/rule.md exists, contains the detailed code examples/exceptions/verification, and itself references no further files. Content is appropriately split between overview and detail with easy navigation; the only trivial redundancy is the trailing 'Rule page:' URL line. | 5 / 5 |
Total | 16 / 20 Passed |