Content
72%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 highly actionable, code-first reference with executable examples across the a11y testing surface, held back by a monolithic inline recipe catalog and the absence of a validate/fix/re-scan feedback loop. Splitting recipe groups into the existing references structure would lift the weaker dimensions.
Suggestions
Move the keyboard-navigation, reporting, and CI recipe groups (and the inline HTML report template) into reference files, keeping SKILL.md as a concise overview that points to them one level deep.
Add an explicit feedback loop: after `analyze()`, if violations exist, log/failureSummary, fix the source, then re-run the scan until `results.violations` is empty.
De-duplicate the per-example `import`/`page.goto`/`AxeBuilder` boilerplate by showing one full setup once and trimming it from subsequent examples.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Body is overwhelmingly lean, executable TypeScript with almost no explanatory padding and no lecturing on what accessibility/WCAG is; not a 5 because the import/goto/AxeBuilder boilerplate repeats across ~12 examples and the inline HTML report template is padded. | 4 / 5 |
Actionability | Fully executable, copy-paste-ready code covering the common cases (full/element/excluded scans, WCAG A/AA/AAA tag sets, specific rules, keyboard nav, contrast, forms, images, ARIA, reporting, CI); specific examples span the typical usage surface. | 5 / 5 |
Workflow Clarity | Each recipe is a clear micro-workflow (goto, scan, assert) but there is no integrated multi-step process and no validate->fix->re-scan feedback loop, which would be natural for a11y testing; not 4 because checkpoints/feedback loops are absent, not 2 because individual steps are well defined. | 3 / 5 |
Progressive Disclosure | Two real reference files are clearly signaled in a References section, but the 412-line body inlines ~15 near-identical recipe blocks and a long HTML template that could be split into reference files; structure is present but content that should be separate is inline. | 3 / 5 |
Total | 15 / 20 Passed |