accessibility-testing

Audit web interfaces for WCAG 2.1/2.2 failures and usability blockers.

364|53|Updated May 9, 2026
One-click install
npx skills add https://github.com/cosmicstack-labs/mercury-agent-skills --skill accessibility-testing-cosmicstack-labs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: accessibility-testing
Source: https://github.com/cosmicstack-labs/mercury-agent-skills/tree/main/categories/testing-qa/accessibility-testing
Command: npx skills add https://github.com/cosmicstack-labs/mercury-agent-skills --skill accessibility-testing-cosmicstack-labs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Web interfaces can fail accessibility standards, leaving users with disabilities unable to use key features and creating compliance risk.

Core Features & Use Cases

  • Automated accessibility audits: Run axe and Lighthouse-style checks to quickly surface common violations in UI markup and behaviors.
  • Manual accessibility verification: Validate keyboard navigation, focus visibility, zoom behavior, and reading order with CSS disabled.
  • Assistive technology testing: Confirm functionality with screen readers such as VoiceOver and NVDA and ensure keyboard-only usability.
  • Remediation guidance: Apply practical fixes like alt text for non-text content, proper ARIA labeling for icon buttons, labeled form fields, and correct heading hierarchy.

Quick Start

Ask for an accessibility test plan and prioritized remediation checklist for your page based on WCAG 2.1/2.2 and include both automated and manual testing steps.

Frequently Asked Questions about accessibility-testing

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

FAQPage Schema
How do I audit web accessibility and fix WCAG violations?

To audit web accessibility, run automated axe and Lighthouse checks alongside manual keyboard and screen reader testing to identify WCAG failures. This process surfaces usability blockers and generates an actionable remediation checklist for ARIA roles, missing labels, and heading hierarchy errors.

What is the best way to test keyboard navigation and screen reader compatibility?

Testing keyboard navigation and screen reader compatibility requires verifying focus visibility and tab order without a mouse. You validate functionality using assistive technologies like VoiceOver and NVDA to ensure ARIA labels are properly announced and keyboard-only users can access all features.

Can I use automated accessibility checks for CI pipelines and pre-release quality gates?

Automated accessibility checks are designed for CI pipelines and pre-release quality gates to catch common UI markup violations. Running axe and Lighthouse-style checks during continuous integration quickly surfaces WCAG failures before deployment, preventing compliance risks in production.

How do I fix ARIA labeling and heading hierarchy issues?

Fix ARIA labeling and heading hierarchy issues by applying proper alt text for images, adding descriptive labels to icon buttons and form fields, and structuring headings logically. Remediation guidance targets these specific semantic failures to restore screen reader compatibility and navigation.

Does manual accessibility testing require disabling CSS and checking zoom behavior?

Manual accessibility testing requires disabling CSS to validate reading order and checking zoom behavior to ensure text remains legible. This verifies that visual presentation does not break underlying document semantics and that users relying on page magnification can read content.