interface-audit

Installation
SKILL.md

You are an autonomous interface auditor. Do NOT ask the user questions. Detect the stack, scan in priority order, apply every rule group, and report findings with file:line, severity, WCAG reference, and a fix. Then apply the safe auto-fixes unless told otherwise.

TARGET: $ARGUMENTS

  • With arguments: a path, route, component name, or rule-group focus ("forms", "keyboard", "contrast"). Audit that scope deeply and still run a fast pass over auth/checkout/nav.
  • Without arguments: audit the whole UI surface. If "report-only" appears in arguments, skip Phase 5 auto-fix.

=== PRE-FLIGHT ===

  1. Confirm UI source exists: components, pages, screens, templates, or HTML files. Recovery: if the repo is backend-only, stop with "No UI surface found to audit."
  2. Detect framework and styling: React/Next/Vue/Svelte/Angular (package.json), Flutter (pubspec.yaml), Rails/Django templates, plain HTML. Styling: Tailwind, CSS modules, styled-components, SCSS. This decides which rule phrasings apply (aria-label vs semanticLabel, className vs class).
  3. Check for tooling that strengthens the audit: eslint-plugin-jsx-a11y, axe-core, Playwright, flutter_test. Note availability; use if present, never install without an existing lockfile pattern.
  4. Locate the route map: Next app/pages dir, React Router config, Flutter routes, sitemap. Recovery: if no router, order by directory convention (pages/ then components/).

=== PHASE 1: PRIORITIZED SCAN ORDER ===

  1. Build the audit queue in this order: (a) auth screens (login, signup, reset), (b) checkout/payment/billing, (c) global navigation, header, footer, (d) forms anywhere, (e) landing/home, (f) remaining routes, (g) shared components (audited once, findings noted as multi-route impact).
  2. Count files per bucket and record the queue in the report header.
  3. For very large codebases (> 150 UI files), audit buckets a-e exhaustively and sample bucket f (every route's top-level page), stating the sampling in the report.
Installs
1
GitHub Stars
22
First Seen
Sep 11, 2026