accessibility-a11y

Implement WCAG accessibility practices with semantic HTML and ARIA roles.

Updated Jan 26, 2026
One-click install
npx skills add https://github.com/shelbeely/ADHD-Closet --skill accessibility-a11y
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: accessibility-a11y
Source: https://github.com/shelbeely/ADHD-Closet/tree/main/.agents/skills/accessibility-a11y
Command: npx skills add https://github.com/shelbeely/ADHD-Closet --skill accessibility-a11y

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill ensures web applications are usable by everyone, regardless of ability, by adhering to accessibility best practices and guidelines.

Core Features & Use Cases

  • WCAG Compliance: Implements standards for accessible web design.
  • Semantic HTML & ARIA: Enhances screen reader compatibility and user experience.
  • Keyboard & Visual Accessibility: Ensures navigation and content are accessible to all users.
  • Use Case: A developer can use this skill to audit and refactor a website's navigation menu to be fully keyboard-navigable and compatible with screen readers, making it accessible to users with motor impairments or visual disabilities.

Quick Start

Apply WCAG 2.1 AA guidelines to the provided HTML structure to ensure full accessibility.

Frequently Asked Questions about accessibility-a11y

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

FAQPage Schema
How do I make my web application accessible for screen readers?

Make web applications accessible for screen readers by implementing semantic HTML and ARIA roles following WCAG guidelines. This ensures proper content interpretation, enabling assistive technologies to navigate and convey information accurately to users with visual disabilities.

What are the WCAG 2.1 AA requirements for keyboard navigation?

WCAG 2.1 AA requirements for keyboard navigation ensure all interactive elements are operable without a mouse. This involves managing focus states, logical tab order, and visible focus indicators to support users with motor impairments.

How do I use ARIA roles to fix semantic HTML accessibility issues?

Use ARIA roles to fix semantic HTML accessibility issues by applying appropriate landmark, widget, and document structure roles. This enhances screen reader compatibility when native HTML elements cannot fully convey the intended user interface behavior.

Does responsive design affect web accessibility for users with disabilities?

Responsive design directly affects web accessibility by ensuring content adapts across various assistive technologies and viewport sizes. Implementing responsive visual design principles maintains readability and usability for users with disabilities on different devices.

What is the best way to audit a navigation menu for WCAG compliance?

The best way to audit a navigation menu for WCAG compliance involves checking keyboard navigability, screen reader compatibility, and focus management. Refactoring the structure ensures the menu is fully accessible to users with motor and visual impairments.

When should I not use ARIA roles for accessible web design?

You should not use ARIA roles when native semantic HTML elements already provide the necessary accessibility semantics. Overusing ARIA can confuse assistive technologies, so prioritize standard HTML elements whenever possible to ensure robust screen reader compatibility.