accessibility-auditing

Audit codebases and live sites for WCAG 2.1/2.2 compliance gaps.

34|3|Updated Oct 17, 2025
One-click install
npx skills add https://github.com/charlesjones-dev/claude-code-plugins-dev --skill accessibility-auditing
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: accessibility-auditing
Source: https://github.com/charlesjones-dev/claude-code-plugins-dev/tree/main/plugins/ai-accessibility/skills/accessibility-auditing
Command: npx skills add https://github.com/charlesjones-dev/claude-code-plugins-dev --skill accessibility-auditing

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill systematically identifies and eliminates barriers to inclusive design, ensuring compliance with WCAG standards. It automates the process of auditing applications for accessibility issues, saving extensive manual review time and preventing legal/ethical issues.

Core Features & Use Cases

  • WCAG Compliance Check: Audits against WCAG 2.1/2.2 (A, AA, AAA) for both codebases and live URLs.
  • Semantic HTML & ARIA Validation: Verifies proper document structure, heading hierarchy, and ARIA implementation for assistive technologies.
  • Keyboard & Visual Accessibility: Assesses keyboard navigation, focus management, and color contrast ratios for readability and usability.
  • Playwright Integration: Conducts visual accessibility testing on live URLs, capturing screenshots as evidence for visual issues.
  • Use Case: Automatically audit your web application for WCAG 2.1 Level AA compliance, identifying issues like missing alt text, insufficient color contrast, and keyboard navigation problems, then generate a prioritized remediation roadmap.

Quick Start

Use the accessibility-auditing skill to perform a WCAG 2.1 Level AA audit of the website 'https://example.com', including visual accessibility testing.

Frequently Asked Questions about accessibility-auditing

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit a website for WCAG 2.1 compliance issues?

WCAG compliance auditing systematically scans your website for accessibility barriers across WCAG 2.1/2.2 levels. The audit identifies missing alt text, insufficient color contrast, broken keyboard navigation, improper ARIA implementation, and form labeling errors, then prioritizes remediation by severity and impact.

Can I test keyboard navigation and screen reader compatibility automatically?

Yes. Automated testing validates keyboard focus management, tab order, and semantic HTML structure that assistive technologies depend on. Live-site testing with Playwright captures evidence of keyboard and screen reader barriers across your application pages.

What accessibility issues does ARIA validation catch?

ARIA validation ensures roles, states, and properties are correctly implemented and match semantic intent. It detects conflicting ARIA attributes, missing live region announcements, improper heading hierarchy, and landmark misuse that confuse assistive technology users.

How do I check color contrast compliance across my UI?

Color contrast auditing measures foreground and background color ratios against WCAG standards (AA or AAA levels). It flags text, buttons, icons, and interactive elements that fail readability thresholds for users with low vision or color blindness.

Does this work with responsive and mobile interfaces?

Yes. Accessibility auditing covers responsive layouts, mobile viewports, touch targets, and viewport scaling. It validates that keyboard navigation, focus indicators, and screen reader output work across all breakpoints and device sizes.

What's the difference between semantic HTML validation and ARIA checking?

Semantic HTML validation ensures proper structure—correct heading levels, list markup, and native elements—which is the foundation assistive tech relies on. ARIA checking validates supplemental roles and attributes that enhance semantics when native HTML is insufficient or must be overridden.