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, actionable body with excellent progressive disclosure (a verified one-level-deep reference and clean section organization). The main drag is conciseness: the no-finding guardrail is stated three times and the Explain section restates generic screen-reader knowledge that could be trimmed or pushed to the reference.
Suggestions
State the "default to no finding unless the snippet shows a concrete issue" guardrail once (in Check) and delete the duplicated bullets in Quick Reference — this alone would tighten the body noticeably.
Replace the generic "Explain" section with a one-line pointer to the Why It Matters section of references/rule.md, since the explanation of how screen readers work is knowledge Claude already has.
Add a short before/after violation example (e.g., an icon rendered as <img src="icon.png"> missing alt='' vs. the corrected form) to lift actionability from 4 to 5.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient — short sections, one useful safe-pattern snippet — but the "default to no finding" guidance is repeated three times ("Do not automatically raise performance findings on decorative micro-assets", "Do not report decorative images as accessibility or performance failures", and the safe-pattern bullet), and the intro sentence plus the generic "Explain" section restate things Claude already knows. Not 4 because the duplication and generic explanation go beyond minor trimming; not 2 because the body is short and largely earns its tokens. | 3 / 5 |
Actionability | Concrete, executable guidance for an instruction-only skill: exact attribute values ("alt='' (empty)", "aria-hidden='true'", "Role='presentation'"), a specific safe pattern (`<img src="/divider.svg" alt="" aria-hidden="true">`), and direct fix instructions ("Add alt='' to decorative img elements... Use CSS background-image for purely decorative visuals"). Not 5 because there is no before/after example of an actual violation, which the common cases would benefit from. | 4 / 5 |
Workflow Clarity | The single-purpose review flow is legible: Quick Reference → Check → Fix → Explain → Code Review, with Check stating exactly what to verify ("Verify decorative images have empty alt attributes (alt=''), decorative icons use aria-hidden='true'"). Not 5 because the body omits any verification step (how to confirm the fix with browser accessibility tooling is mentioned only in passing, and the actual Verification section lives in the reference without being signposted); no destructive/batch operations, so no cap applies. | 4 / 5 |
Progressive Disclosure | This is a simple skill under 50 lines with well-organized sections and a clearly signaled one-level-deep reference: "For full implementation details, code examples, and framework-specific guidance, see `references/rule.md`" — the file exists and its headers (Code Example, Decorative SVGs and Icons, Verification, etc.) match the promised content. Content split is appropriate and navigation is easy. | 5 / 5 |
Total | 16 / 20 Passed |