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 and points cleanly to a real reference file, with actionable checking and fixing guidance. It is held back by redundancy between the intro/Quick Reference/Explain sections and by the absence of an explicit verification step in the body's workflow.
Suggestions
Remove the redundant 'Explain' section (or trim it to a single line), since WCAG thresholds and platform guidance already appear in Quick Reference and references/rule.md.
Add an explicit 'Verify' step to the body workflow (e.g., 'Re-measure the rendered bounding box; confirm >=24px AA or >=44px AAA') rather than relying solely on references/rule.md for verification.
Tighten the intro paragraph by dropping the enumeration of specific motor disabilities, which Claude already knows and which does not change the action.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The intro paragraph explains motor disabilities (essential tremor, Parkinson's, hemiplegia) and the 'Explain' section restates WCAG numbers, 44px/24px thresholds, and Apple/Google guidance already present in Quick Reference, creating noticeable redundancy. | 3 / 5 |
Actionability | The 'Check' section gives concrete flagging thresholds (<24px, <44px, 24px spacing) and 'Fix' provides executable CSS techniques including a real pseudo-element snippet (`inset: -12px`), with fuller examples deferred to references. | 4 / 5 |
Workflow Clarity | A Check -> Fix -> Code Review sequence is present, but the body lacks an explicit verification checkpoint confirming the fix meets the threshold; validation lives only in references/rule.md, leaving checkpoints implicit. | 3 / 5 |
Progressive Disclosure | The body is well-sectioned (Quick Reference, Check, Fix, Explain, Code Review) and points clearly one level deep to references/rule.md (a real file), though the 'Explain' section duplicates content that already exists in the reference. | 4 / 5 |
Total | 14 / 20 Passed |