Content
67%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.
The body is a compact, well-organized overview with genuinely actionable Check and Fix procedures and a properly structured one-level-deep reference bundle. Its weaknesses are redundancy — the name-computation rules and aria-expanded guidance repeated across sections plus a boilerplate Code Review paragraph — and verification existing only as a passing mention rather than an explicit workflow step.
Suggestions
State the accessible-name computation order (aria-labelledby, then aria-label, then text content) once — in Check — and drop the duplicate restatements in Quick Reference and Fix.
Replace the generic 'Code Review' boilerplate paragraph with a concrete verification step, e.g. inspecting the accessibility tree for empty-named treeitems or running an axe check with the [role='treeitem'] selector.
Trim the duplicated aria-expanded guidance spread across Quick Reference, Check, Fix, and Explain down to a single location, keeping the rest of the body's focus on names.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Each section is individually tight, but the accessible-name computation order (aria-labelledby, then aria-label, then text) is stated three times (Quick Reference, Check, Fix), the aria-expanded point appears in four sections, and the 'Code Review' paragraph is generic boilerplate ('Flag exact elements, roles, labels, focus behavior, or keyboard interactions...') that could be trimmed. Mostly efficient with unnecessary repetition to tighten fits anchor 3; it is not 2 because no section teaches basic concepts Claude doesn't know at length. | 3 / 5 |
Actionability | The Check section gives an ordered, attribute-level procedure ('check aria-labelledby first, then aria-label, then visible text content') and Fix gives a concrete 4-step decision list with specific attribute remedies (e.g., 'add aria-label=\'Descriptive name\'', 'use aria-labelledby referencing the most descriptive element\'s id'). It is not 5 because no inline markup example or automated-check command (e.g., an axe selector) appears in the body — the executable example is deferred to the reference file, which is acceptable for an instruction-only skill but leaves minor gaps. | 4 / 5 |
Workflow Clarity | The Check-then-Fix structure forms a clear sequence with an ordered fix decision procedure, appropriate for a simple single-purpose non-destructive skill. It is not 5 because verification is only mentioned in passing ('note how to verify the fix with browser accessibility tooling or assistive tech') rather than given as an explicit validation step in the workflow, and the operational order of the six sections (Quick Reference through Code Review) is left implicit. | 4 / 5 |
Progressive Disclosure | The body is a clear overview with a well-signaled, verified, one-level-deep reference ('see references/rule.md'), which exists and appropriately holds the code example, ARIA property table, and verification steps. It is not 5 because the pointer mislabels the reference's contents (promising 'framework-specific guidance' that rule.md does not contain) and several points (Why It Matters, required ARIA properties) are duplicated between body and reference rather than cleanly split. | 4 / 5 |
Total | 15 / 20 Passed |