a11y

Run an accessibility-only audit — focus indicators, skip links, alt text, prefers-reduced-motion, WCAG contrast. Scoped variant of /ui-ux-suite:audit.

/ui-ux-suite:a11y — Accessibility-only audit

Scoped audit on accessibility fundamentals.

What you do

  1. Resolve project path.
  2. Call uiux_audit_run with dimensions: ["accessibility"]. Pass depth: "deep" if the user included --deep AND baseUrl is known — this triggers optional Playwright + axe-core live scanning (requires opt-in peer deps).
  3. If peer deps for --deep are missing, print the exact install hint: npm i -D playwright-core @axe-core/playwright && npx playwright install chromium, then fall back to static analysis.
  4. Present the accessibility section of the markdown report.
  5. Rank findings by WCAG severity (critical violations first).

What a11y audit covers

  • Visible focus indicators (:focus-visible styling)
  • Skip-to-content links
  • Alt text on images
  • prefers-reduced-motion support
  • ARIA label coverage (rough signal)
  • WCAG contrast failures
  • Landmark roles (in --deep mode)
  • Touch-target sizing (in --deep mode, flags < 44x44)

Keep it honest — if we can only scan statically, say so. Static analysis cannot catch dynamic violations (collapsed layouts, invisible focus rings on hover states). --deep catches those.