Content
85%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 overview with a concrete Check/Fix workflow, an explicit per-input validation checklist, and a well-signaled one-level reference to rule.md (verified present with full code examples). Its only notable weakness is mild redundancy between the intro and Explain sections, which re-cover screen-reader and accessible-name concepts Claude already knows.
Suggestions
Collapse the overlap between the intro and the Explain section — keep the accessible-name computation order and WCAG citations once, and trim the second restatement of screen-reader/Dragon behavior.
Optionally surface one small inline correct/incorrect snippet in the Fix section so the remediation is copy-paste ready without opening rule.md.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is well-organized and avoids the verbose wall-of-basics seen in the score-1 anchor, but the intro and the Explain section overlap — both re-explain screen-reader behavior ("VoiceOver reads 'text field' and NVDA reads 'edit'") and the accessible-name/Dragon use case that Claude already knows, so it could be tightened rather than earning the 'every token earns its place' score of 3. | 2 / 3 |
Actionability | The Check and Fix sections give concrete, specific remediation with real HTML attribute values ("<label for='input-id'>Label text</label> and matching id", "aria-label='Search'", "aria-labelledby='label-element-id'"). This is an instruction/review skill, so per the scoring notes the absence of full fenced code blocks in the body is not penalized when the guidance is this actionable, and complete executable examples are appropriately provided in references/rule.md. | 3 / 3 |
Workflow Clarity | The workflow is clearly sequenced as Check (find inputs, then validate each against three explicit numbered conditions and flag placeholder-only labels) → Fix (three ordered remediation options plus removing placeholder) → Code Review (verify with browser accessibility tooling). The Check section's three conditions serve as an explicit validation checkpoint, which fits the score-3 anchor for a review skill. | 3 / 3 |
Progressive Disclosure | The body is a concise overview split into clear sections (Quick Reference, Check, Fix, Explain, Code Review) with a clearly signaled one-level-deep pointer — "For full implementation details, code examples, and framework-specific guidance, see references/rule.md" — and that reference file exists and holds the complete code examples, standards, and verification steps, matching the score-3 anchor. | 3 / 3 |
Total | 11 / 12 Passed |