a11y-audit-guide - SKILL.md Agent Skill

name: a11y-audit-guide description: Use when auditing one or more web URLs with Playwright and axe-core, producing JSON and Markdown accessibility reports for rendered pages across React, Next.js, Vue, Angular, Spring/Thymeleaf, or static HTML.

Run a Playwright + axe audit for one or more web URLs and produce JSON plus Markdown reports. Do not edit code with this skill.

Confirm the target URL or URL list; read ../../references/config-examples.md only if config-based multi-page input is needed.
If runtime readiness is unclear, read ../../references/runtime-strategy.md; do not install by default.
Run the scripted audit or documented fallback to produce JSON and Markdown reports.
Classify with ../../references/axe-result-policy.md.
Summarize critical and serious violations first, then list incomplete as manual-review items.

From the plugin scripts/ directory:

npm run audit -- --url <url>
npm run audit -- --urls <url1,url2> --output-dir <report-dir>
npm run audit -- --config <path-to-audit-config.json>

State whether the report used the scripted runner, a fresh setup, or a fallback.
Produce both .json and .md outputs for every audit.
Treat report selectors as rendered DOM locations, not source-code locations.