Accessibility Audit — Development

The Accessibility Audit skill provides a complete WCAG 2.2 Level A and AA audit pipeline for web applications. It scans codebases for violations, generates framework-specific fixes, verifies corrections, and produces compliance reports suitable for stakeholders and CI/CD integration.

engineering claude-code

📂 View skill on GitHub ↗ 🚀 How to use

✨ What it does

Scans for all WCAG 2.2 Level A and AA violations with severity classification.
Auto-detects framework (React, Next.js, Vue, Angular, Svelte, HTML).
Generates framework-specific before/after fix code for each violation.
Includes a color contrast checker with suggestions for accessible alternatives.
Produces stakeholder-ready compliance reports and CI/CD integration configs.
Validates ARIA usage and keyboard navigation patterns.

🎯 When to use it

When auditing a codebase for WCAG 2.2 Level A and AA compliance.
When fixing accessibility violations and needing exact before/after code examples.
When checking color contrast ratios against AA or AAA standards.
When generating accessibility compliance reports for stakeholders.
When integrating accessibility checks into CI/CD pipelines.

🚀 How to use

Trigger: /a11y-audit

Trigger the skill with the slash command /a11y-audit or by requesting an accessibility audit. Provide the project path or directory to scan. Options include --scope, --fix, --report, and --ci. Example prompts:

/a11y-audit --scope src/
Run an accessibility audit on my project and fix all issues.

📄 Output: The skill outputs a structured audit report listing violations with severity, WCAG criteria, and suggested fixes, optionally as JSON or CSV, and can generate a stakeholder-ready compliance report.

📦 Add this skill to Claude Code

# 1. Get the skills repo
git clone --depth 1 https://github.com/alirezarezvani/claude-skills /tmp/claude-skills

# 2. Copy this skill into your project (or ~/.claude/skills for all projects)
mkdir -p .claude/skills
cp -r /tmp/claude-skills/engineering-team/a11y-audit/skills/a11y-audit .claude/skills/a11y-audit

Skill source: engineering-team/a11y-audit/skills/a11y-audit/SKILL.md

⚠️ Good to know

Requires Python to run the scanner and contrast checker scripts; the skill provides code fixes but does not automatically apply them unless the --fix option is used.

❓ FAQ

What frameworks are supported?

The skill supports React, Next.js, Vue, Angular, Svelte, and plain HTML, with auto-detection.

How does the skill classify violations?

Violations are categorized as Critical, Major, or Minor based on severity definitions, with SLAs for fixing.

Can I integrate this into CI/CD?

Yes, the skill provides CI/CD integration configurations for GitHub Actions, GitLab CI, and Azure DevOps, and a --ci mode that exits non-zero on critical issues.

🤖 Overview, features, install steps and FAQ were generated from the project's SKILL.md on Sep 4, 2026. Always check the original source before running commands.