Content
81%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 well-organized, lean checklist-style skill with concrete before/after code examples, clear priorities, and an explicit review workflow. Its minor gaps are placeholder-laden fix examples, some rules that restate widely known WCAG basics, and a rule catalog that could be offloaded to a reference file as the skill grows.
Suggestions
Make the 'common fixes' examples fully copy-paste ready by replacing the '<svg>...</svg>' ellipses with minimal complete elements.
Trim quick-reference rules that restate knowledge Claude already has (e.g., 'links must have meaningful text') down to only the non-obvious constraints, or move the full 9-category rule catalog into a references/ file and keep a short priority summary in SKILL.md.
Name one or two established accessible primitives (e.g., specific dialog/menu libraries or ARIA Authoring Practices patterns) so the 'prefer established primitives' guidance is executable.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is a lean rule catalog: terse directives ("modals must trap focus while open", "do not use tabindex greater than 0") and compact before/after snippets with no filler or concept explanations, so it is well above anchor 3. It is not a 5 because a portion of the quick-reference rules restate standard WCAG knowledge Claude already has (e.g., "links must have meaningful text", "images must have correct alt text"), which could be trimmed without loss. | 4 / 5 |
Actionability | Concrete, code-level guidance is present: a priority table, exact attributes to apply (aria-describedby, aria-invalid, aria-expanded), and executable before/after HTML in the "common fixes" block, plus an explicit review output format (quote the snippet, state the failure, propose a small fix). Not a 5 because the fix examples use ellipsis placeholders ("<svg>...</svg>") rather than fully copy-paste-ready code, and complex-widget guidance defers to "established accessible primitives" without naming any. | 4 / 5 |
Workflow Clarity | As a simple single-purpose instruction skill, both usage modes are unambiguous: constraint mode ("Apply these constraints to any UI work") and file-review mode with an explicit report structure (violations with quoted lines, why it matters, a concrete fix) plus priority ordering ("fix critical issues first (names, keyboard, focus, tool boundaries)") and a scoped-change rule ("Do not rewrite large parts of the UI"). No destructive or batch operations exist, so no validation checkpoints are required; the single action is unambiguous, meeting the simple-skill exception. | 5 / 5 |
Progressive Disclosure | Structure is good: a priority table up front, nine clearly headed rule categories ordered by priority, a common-fixes example block, and a closing review-guidance section, with no external bundle files present or needed. Not a 5 because the body exceeds the under-50-lines simple-skill threshold, and the nine-category rule catalog (~90 lines of rules) could arguably be split into a reference file to keep SKILL.md a leaner overview; still clearly above anchor 3 since everything present is well-signaled and navigable. | 4 / 5 |
Total | 17 / 20 Passed |