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.
A well-structured, brief body with a clear Check→Fix flow and an appropriate one-level-deep reference that genuinely holds the implementation details. The main weakness is redundancy: the meter rationale is explained three times (intro, Quick Reference bullet, Explain section) and the Code Review section is boilerplate that adds little over the description.
Suggestions
Cut the duplicated rationale — keep one of the intro sentence, the 'Helps users understand what measurement is being displayed' bullet, or the 'Explain' section, and drop the `<meter>` definition Claude already knows.
Replace the generic 'Code Review' boilerplate with one concrete inline example of a correctly labeled meter (aria-label and aria-labelledby variants) or a named verification step such as 'inspect the accessibility tree / run axe to confirm the accessible name'.
Make the reference a markdown link (e.g., [references/rule.md](references/rule.md)) so the pointer to detail is unambiguous.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient but includes unnecessary explanation: the intro 'A meter represents a scalar measurement; without a label, a user might hear a value (e.g., '50%')...' explains a concept Claude already knows, and the same rationale is repeated in 'Helps users understand what measurement is being displayed' and the 'Explain' section, while 'Code Review' is boilerplate restating the description. Not 2: the body is short (~30 lines), sectioned, and scannable rather than noticeably padded. Not 4: the duplicated rationale and the meter definition could clearly be trimmed. | 3 / 5 |
Actionability | Concrete, executable guidance: 'Check for `<meter>` elements or elements with `role="meter"` that lack an accessible name' and 'Add an `aria-label` or `aria-labelledby` to the meter element' name the exact elements, roles, and fix attributes. Not 5: no example markup of correct/incorrect usage appears in the body (it is deferred to the reference) and no specific verification tool is named inline. Not 3: per the rubric's instruction-skill note, absence of code is not penalized when the guidance is this specific and actionable. | 4 / 5 |
Workflow Clarity | A clear '## Check' then '## Fix' sequence makes the single action unambiguous, and 'note how to verify the fix with browser accessibility tooling or assistive tech' acknowledges verification. Not 5: verification is framed as an instruction to 'note how' rather than a concrete checkpoint (e.g., 'confirm the accessible name in the accessibility tree' or 'run axe'), so the validation step stays implicit. Not 3: the check-to-fix flow has no gaps and this is not a destructive or batch operation requiring a validation cap. | 4 / 5 |
Progressive Disclosure | The body is a lean overview with well-ordered sections and one 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 in the bundle and contains exactly those details (code examples, why-it-matters, exceptions, verification). Not 4: there are no organization gaps — the split between overview and detail is appropriate and navigation is trivial. | 5 / 5 |
Total | 16 / 20 Passed |