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 expert-advisory skill with a clearly signaled one-level reference, concrete tools and test parameters, and a coherent audit workflow. Its main cost is token weight: the full success-criteria inventory re-encodes much baseline WCAG knowledge that could be compressed to the deltas and reliability-critical details Claude cannot recall verbatim.
Suggestions
Compress the four POUR principle tables to criterion number, level, and version-origin marker (e.g., '2.2') plus only the non-obvious requirements, and move the 'Common Failures' column into references/criteria-detail.md — Claude can generate typical failures itself.
Add one worked example per key output format (e.g., a filled-in audit-table row or a short accessibility-statement skeleton) so the mandated formats in 'How to Respond' are unambiguous.
Add an explicit validation checkpoint to the audit workflow — re-test each remediated criterion and re-run the automated scan before documenting final pass/fail status.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and un-padded, but the ~100-row success-criteria tables restate a substantial amount of what Claude already knows (e.g., "Alt text for all images", "Grey text on white" under 1.4.3, basic POUR definitions), which the rubric explicitly penalizes. It could be tightened to deltas, levels, and version-origin markers that Claude cannot reliably recall, with the rest in the reference file; not a 2 because there is no prose padding and the tables are the skill's core reference value. | 3 / 5 |
Actionability | Guidance is concrete and executable for an instruction-only skill: named tools ("axe-core, Lighthouse, WAVE, or IBM Equal Access Checker"), exact test parameters ("zoom to 400%; viewport at 320 CSS px"), specific screen reader/browser pairings, the contrast formula, and a task-to-output-format table. Not a 5 because there are no worked examples or sample outputs (e.g., a model audit-table row or statement skeleton) for the output formats it mandates. | 4 / 5 |
Workflow Clarity | The Full Accessibility Audit is a clear 7-step numbered sequence where each step names the tools and maps to the SCs it tests ("Screen reader test — NVDA + Chrome ... Tests SC 1.1.1, 1.3.1, 4.1.2"). Not a 5 because there is no explicit validation/re-test checkpoint (e.g., verify fixes or re-run the scan after remediation), which the anchor-5 example requires; not a 3 because each step is itself a concrete check with named tools rather than an implicit or missing checkpoint. | 4 / 5 |
Progressive Disclosure | The body is a well-organized overview (per-criterion one-row summaries) that defers per-criterion techniques and failures to a clearly signaled, one-level-deep reference — "references/criteria-detail.md — Full WCAG 2.2 success criteria with techniques, sufficient techniques, advisory techniques, and failure techniques" — which exists in the bundle and has its own table of contents for navigation. No inline duplication of the reference's detail and no nested references. | 5 / 5 |
Total | 16 / 20 Passed |