Content
63%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 lean, well-organized overview that correctly pushes detail to a real, one-level-deep reference file with clear navigation. Its weaknesses are redundancy between the Check/Quick Reference/Explain sections and the absence of any inline markup example, which leaves the immediately actionable guidance thinner than it could be for an HTML-focused rule.
Suggestions
Merge the "Check" section into "Quick Reference" (they say the same thing) and drop or concretize the generic "Explain" section to eliminate redundancy.
Inline one minimal correct/incorrect <label for> + <select> snippet in the "Fix" section so the body is immediately actionable without loading the reference.
Promote the verification mention to an explicit checkpoint step, e.g., "Verify: confirm the accessible name in the browser accessibility tree and run axe/Lighthouse", ideally with a pointer to the Verification section of rule.md.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | "Check that every `<select>` element in your forms has a valid accessible name or linked label" largely duplicates the Quick Reference bullets, and the generic "Explain how accessible names for select elements provide the necessary context..." section adds little. Not 4 because of this redundancy across Check/Explain/Code Review; not 2 because the body is short, assumes competence, and never explains basics Claude already knows. | 3 / 5 |
Actionability | "Add a `<label>` element with a `for` attribute that matches the `id` of the `<select>` tag" is concrete, but the body contains no inline executable code example (all code is deferred to the reference) and the aria-label/aria-labelledby alternatives are only named, never shown. Not 4 because an instruction-only skill of this type should include at least a minimal correct/incorrect markup snippet or specifics for the aria path; not 2 because the fix and check directives are specific enough to act on. | 3 / 5 |
Workflow Clarity | The Check → Fix → Code Review section order forms a coherent sequence for a simple single-purpose skill, and verification is signaled via "note how to verify the fix with browser accessibility tooling or assistive tech". Not 5 because there is no explicit validate-checkpoint or fix-and-retry loop in the body itself; not 3 because verification is at least mentioned and the single action is unambiguous. | 4 / 5 |
Progressive Disclosure | "For full implementation details, code examples, and framework-specific guidance, see `references/rule.md`" is a clearly signaled, one-level-deep reference, and the bundle file exists and delivers exactly what is promised (code examples, why-it-matters, verification steps). The overview/body split is appropriate for a short skill, matching the 'clear overview with well-signaled one-level-deep references' anchor. | 5 / 5 |
Total | 15 / 20 Passed |