accessibility-testing

Diagnose web application accessibility issues for WCAG 2.2 compliance.

436|78|Updated Sep 11, 2025
One-click install
npx skills add https://github.com/proffesor-for-testing/agentic-qe --skill accessibility-testing
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: accessibility-testing
Source: https://github.com/proffesor-for-testing/agentic-qe/tree/main/.claude/skills/accessibility-testing
Command: npx skills add https://github.com/proffesor-for-testing/agentic-qe --skill accessibility-testing

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @axe-core/playwright, pa11y, lighthouse, chrome-launcher.

What problem does it solve?

This Skill ensures software is usable by everyone, including people with disabilities, addressing legal compliance (ADA, Section 508) and expanding market reach to the 1 billion disabled users globally.

Core Features & Use Cases

  • WCAG 2.2 Compliance: Guides through testing against Web Content Accessibility Guidelines (WCAG) 2.2 Level AA, covering Perceivable, Operable, Understandable, and Robust principles.
  • Screen Reader Validation: Provides techniques for testing with major screen readers (JAWS, NVDA, VoiceOver) and a checklist for common issues.
  • Automated & Manual Testing: Combines automated tools (axe-core, Pa11y, Lighthouse) with essential manual techniques (keyboard navigation, color contrast, text resize).
  • Use Case: Use this Skill to automatically scan your web application for WCAG 2.2 violations in CI/CD, then manually verify critical user flows with a screen reader to ensure full compliance.

Quick Start

Use the accessibility-testing skill to run an automated WCAG 2.2 Level AA scan on your homepage and generate a report of all violations.

Frequently Asked Questions about accessibility-testing

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

FAQPage Schema
How do I test my website for WCAG 2.2 compliance?

WCAG 2.2 compliance testing combines automated scanning with manual validation. Use axe-core or Pa11y to automatically detect violations against WCAG 2.2 Level AA standards, then manually verify keyboard navigation, screen reader compatibility, and color contrast to ensure full compliance across all user interactions.

Can I automate accessibility testing in my CI/CD pipeline?

Yes. Integrate axe-core with Playwright or use Pa11y and Lighthouse to run automated accessibility scans on every code change. These tools generate violation reports that flag WCAG issues before release, enabling continuous compliance validation without manual intervention each build.

What's the best way to test screen reader compatibility?

Screen reader validation requires testing with JAWS, NVDA, or VoiceOver to verify semantic HTML, ARIA attributes, and navigation flows. Combine this manual testing with automated checks from axe-core to catch common issues like missing alt text, improper heading structure, and broken landmark roles.

How do I verify keyboard navigation works correctly?

Keyboard navigation validation ensures all interactive elements are reachable via Tab key, focus is visible, and logical tab order exists. Test manually by navigating your site without a mouse, then use automated tools to detect missing keyboard handlers and ARIA attributes that enable assistive technology access.

Do I need to test color contrast for accessibility?

Yes. Color contrast is a WCAG 2.2 requirement for perceivable content. Use automated tools like axe-core or Lighthouse to identify text and UI elements that fail contrast ratios, then remediate by adjusting foreground or background colors to meet AA or AAA standards for readability.

Can automated tools catch all accessibility issues?

Automated tools detect 30–50% of accessibility issues, including contrast failures and missing ARIA labels. Manual testing with keyboard navigation and screen readers is essential to catch nuanced problems like ambiguous button labels, confusing form instructions, and poor content structure that automated scanning alone cannot identify.