Content
85%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, appropriately brief body: tight Quick Reference bullets, an unambiguous single-action check/fix workflow, and a clean one-level-deep pointer to references/rule.md that verifiably exists. The only weaknesses are minor — a small amount of redundant/boilerplate text and no inline markup example, both of which keep conciseness and actionability at 4 rather than 5.
Suggestions
Inline one minimal good/bad markup pair in the Fix section (e.g. <div role="progressbar" aria-label="Uploading files" aria-valuenow="70" ...>) so the fix is copy-paste ready without opening the reference.
Merge the intro motivation sentence with the Explain section — they make the same point about screen-reader users lacking context — to trim tokens.
Cut the generic Code Review boilerplate about focus behavior and keyboard interactions, which is outside this rule's naming scope.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean: a one-line motivation, five tight Quick Reference bullets, and one-sentence Check/Fix/Explain sections. Not a 5 because of minor over-explanation — the intro sentence ("screen reader users will only hear that a progress bar exists") overlaps with the Explain section, and the Code Review paragraph is generic boilerplate ("focus behavior, or keyboard interactions") that pads beyond this rule's scope. | 4 / 5 |
Actionability | Guidance is concrete and executable: "Use `aria-label` or `aria-labelledby` to name progress bars", "Provide `aria-valuenow`, `aria-valuemin`, and `aria-valuemax`", and the Check names the exact selector (role="progressbar"). Not a 5 because no markup example appears in the body — all copy-paste-ready code lives in references/rule.md — so the Fix section tells what to add but not what the fixed element looks like. | 4 / 5 |
Workflow Clarity | This is a simple single-purpose skill (~35 lines) whose single action is unambiguous: check that role="progressbar" elements have an accessible name via aria-label/aria-labelledby, then fix with the same attributes — meeting the simple-skill exception for a 5. The Check/Fix/Explain sequence confirms the one action is unambiguous, and no destructive/batch validation is required. | 5 / 5 |
Progressive Disclosure | The bundle structure matches the disclosure pattern: references/rule.md exists (verified, 58 lines with the ARIA code examples) and is clearly signaled at the end of the body — "For full implementation details, code examples, and framework-specific guidance, see `references/rule.md`" — exactly one level deep with no nesting. Quick-reference content is appropriately in the body and detail appropriately in the reference. | 5 / 5 |
Total | 18 / 20 Passed |