a11y-audit

Installation
SKILL.md

Accessibility Audit

Category: Engineering Domain: Web Accessibility

Overview

The agent uses this skill to scan HTML source for WCAG 2.1 violations (plus WCAG 2.2 SC 3.3.8, paste blocking on credential fields) and to check colour contrast against AA/AAA. It catches missing alt text, broken heading hierarchies, unlabeled form inputs and low contrast early, before a browser-based audit. The rule set targets WCAG 2.1 on purpose: the other WCAG 2.2 additions (target size, focus not obscured, dragging alternatives) depend on rendered layout and need a browser or manual check.

When to Use

  • Reviewing HTML templates or static pages for accessibility before release.
  • Checking a palette or a stylesheet's colour pairs against AA/AAA contrast.
  • Adding a Level A gate to CI for template changes.
  • Triaging an accessibility bug report down to specific elements.

Clarify First

Before running the audit, settle the inputs below. When one is missing or vague and would change the result, ask about it; when it wouldn't, use a sensible default and say which one you used.

Installs
75
GitHub Stars
1.2K
First Seen
Apr 3, 2026