- name
Audits existing interfaces for WCAG 2.2 AA conformance and remediates the violations found. Use when auditing a page or component for accessibility, running axe-core or pa11y, triaging a11y violations
SKILL.md
The skill file stays in the publisher's repository.
Paste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add addyosmani/agent-skills --skill accessibility-engineering -a cursor -yPaste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add addyosmani/agent-skills --skill accessibility-engineering -a claude-code -yPaste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add addyosmani/agent-skills --skill accessibility-engineering -a codex -yPaste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add addyosmani/agent-skills --skill accessibility-engineering -a grok -ySend the copied message in a Grok Bot chat. The Bot fetches this SKILL.md from GitHub and adds it to the skills all your Bots share.
Install this skill: https://github.com/addyosmani/agent-skills/tree/HEAD/skills/accessibility-engineeringFrom the publisher
Accessibility is not a polish step — it's a legal requirement in many jurisdictions, an engineering quality standard, and a prerequisite for shipping. This skill audits existing interfaces, triages the findings, and remediates verified violations. The goal is WCAG 2.2 AA compliance supported by automated tools and manual testing.
Do NOT use for building new UI components from scratch; use frontend-ui-engineering for construction guidance. Do not use for backend-only changes, CLIs, or library code with no UI output.
For component construction, interaction patterns, and focus-management guidance, use ../frontend-ui-engineering/SKILL.md. Do not restate that skill here. Return to this workflow once an interface exists and needs auditing or remediation.
Execute accessibility checks in this order:
# axe-core rules through pinned @axe-core/cli (the axe-core package ships no CLI)
npx --yes @axe-core/[email protected] http://localhost:3000 --exit
# Keep the JSON for the accessibility-auditor
npx --yes @axe-core/[email protected] http://localhost:3000 --dir ./a11y-reports --save axe.json
# Pinned pa11y for HTML validation (WCAG2AA rules via HTML_CodeSniffer)
npx --yes [email protected] http://localhost:3000
For a combined report, run bash skills/accessibility-engineering/scripts/audit-a11y.sh url <url> --json. It runs both pinned tools, records their status and versions, and fails rather than reporting a clean result when either tool does not produce a valid report.
Review the violations grouped by severity:
For each violation, verify it's a real issue (not a false positive) by inspecting the element in the browser.
Automated checks are a smoke test, not proof of conformance. Complete the audit manually.
Keyboard audit:
Screen reader audit (VoiceOver on macOS, NVDA on Windows):
Visual audit:
For each finding, apply the remediation in order:
<div> with <button>, add <label>, set alt textApply the accessibility checklist (../../references/accessibility-checklist.md) as a minimal baseline.
alt text on meaningful images (or alt="" missing on decorative ones)../../references/accessibility-checklist.md — Quick reference for WCAG 2.2 AA../frontend-ui-engineering/SKILL.md — Building accessible components from the start../../agents/accessibility-auditor.md — Dedicated a11y audit persona for deep reviewsAfter completing the accessibility workflow:
manual and untested — never reported as verified)alt text© 2026 Skills Rack.
---name: accessibility-engineeringdescription: Audits existing interfaces for WCAG 2.2 AA conformance and remediates the violations found. Use when auditing…---# skills/accessibility-engineering/SKILL.mdOverview
Audits existing interfaces for WCAG 2.2 AA conformance and remediates the violations found. Use when auditing a page or component for accessibility, running axe-core or pa11y, triaging a11y violations, or checking screen reader and contrast issues before shipping.
FAQ
Download skills/accessibility-engineering/SKILL.md from the publisher, or copy the path and open the repository. PlugMCP lists the skill and does not host the file.
The publisher keeps it at https://github.com/addyosmani/agent-skills.
Claude, Cursor, Codex, and Grok Build can read a SKILL.md you add from the publisher's repository. Grok Bot installs it when you send the skill's GitHub folder link in a chat.