Content
78%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.
A well-structured, token-efficient overview that pairs a concrete Quick Reference with a clean one-level-deep pointer to references/rule.md for code and verification. The main gap is that the Check/Fix sections stay high-level while the actionable detail lives entirely in the reference file.
Suggestions
Inline one tiny before/after markup snippet (e.g., aria-expanded="yes" -> "true") in the Quick Reference so the body is actionable without opening the reference.
Add a one-line 'Verify' pointer in the body (e.g., 'Confirm via the accessibility tree or axe/Lighthouse') to surface the validation checkpoint that currently lives only in rule.md.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes competence (no padding about what ARIA is), though the templated 'Check'/'Fix' lines ('Validate that all ARIA attribute values conform to the allowed types') could be tightened further. | 4 / 5 |
Actionability | The Quick Reference gives concrete, copy-ready examples ('aria-expanded="true"', 'yes/no' vs 'true/false', ID references in 'aria-labelledby'/'aria-owns'), while the Check/Fix sections stay somewhat abstract; executable code is offloaded to references/rule.md. | 4 / 5 |
Workflow Clarity | The Check -> Fix -> Explain -> Code Review headings form a coherent review sequence, and verification guidance lives in references/rule.md; the body itself lacks an explicit validation checkpoint, but this is a non-destructive review skill so the cap does not apply. | 4 / 5 |
Progressive Disclosure | A concise overview with a single, clearly signaled one-level-deep reference ('see references/rule.md') that exists in the bundle; content is appropriately split and easy to navigate. | 5 / 5 |
Total | 17 / 20 Passed |