Content
57%Reviews 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, lean overview that correctly defers code and verification detail to a single one-level-deep reference, but it carries minor redundancy (Fix restating Quick Reference), a vague Check step, and only implicit inline validation checkpoints.
Suggestions
Make the '## Check' step concrete (e.g. 'Inspect the accessibility tree for each <select>; confirm a name is present via <label for>, aria-label, or aria-labelledby') instead of restating the goal.
Surface a one-line inline verification checkpoint (e.g. 'Verify with axe/Lighthouse or the browser accessibility tree that each <select> exposes a name') before pointing to rule.md, so the workflow has an explicit validation step.
Drop or merge the meta '## Explain' section to remove filler and avoid the Fix/Quick Reference overlap.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is short and does not over-explain basics, but the '## Fix' section restates the Quick Reference bullet ('Use the <label> element with a matching for attribute') and the '## Explain' section is meta-instructional filler ('Explain how accessible names... provide the necessary context'). This matches score 2 'mostly efficient but... could be tightened' rather than score 3's 'every token earns its place'. | 2 / 3 |
Actionability | Quick Reference and Fix give concrete, copy-paste-ready guidance ('<label> with a for matching the id', 'aria-label or aria-labelledby'), but the '## Check' section is vague ('Check that every <select>... has a valid accessible name') and no executable code example is inline (code is deferred to references/rule.md). This is above score 1 (which requires purely abstract direction) but below score 3's 'fully executable code/commands; copy-paste ready' because the inline guidance is incomplete. | 2 / 3 |
Workflow Clarity | A light sequence exists (Check -> Fix -> Code Review) and the Code Review section mentions verifying the fix 'with browser accessibility tooling or assistive tech', but explicit validation checkpoints are not stated inline and the actual verification steps live in references/rule.md. This matches score 2 'steps listed but validation gaps; checkpoints missing or implicit' rather than score 3's 'explicit validation steps'. | 2 / 3 |
Progressive Disclosure | The body is a concise overview and ends with a clearly signaled, one-level-deep reference ('see references/rule.md') for 'full implementation details, code examples, and framework-specific guidance'. The bundle file references/rule.md exists and holds the code/verification detail, matching score 3 'clear overview with well-signaled one-level-deep references'. | 3 / 3 |
Total | 9 / 12 Passed |