client-a11y

Codify UI development guidelines for accessible components with ARIA and semantic HTML.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/juchanhwang/missionary --skill client-a11y
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: client-a11y
Source: https://github.com/juchanhwang/missionary/tree/main/.claude/skills/client-a11y
Command: npx skills add https://github.com/juchanhwang/missionary --skill client-a11y

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides guidelines for web accessibility coding, covering the three-screen-reader elements (roles, labels, states) and four principles (structure, meaning, predictability, and visual information augmentation) to help build accessible UI. It includes practices for UI component creation and review, ARIA attributes, keyboard accessibility, and semantic HTML usage.

Core Features & Use Cases

  • Defines the mental model for accessible UI: roles, labels, and states, and how to apply ARIA when needed.
  • Offers concrete rules for structuring components, semantic HTML, and keyboard navigation to improve accessibility in real-world apps.
  • Use Case: Auditing a React or Next.js app to ensure all interactive controls have proper roles, labels, states, and ARIA attributes.

Quick Start

Audit a sample UI to identify interactive elements and apply the accessibility guidelines immediately.

Frequently Asked Questions about client-a11y

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

FAQPage Schema
How do I audit a React app for web accessibility and screen reader support?

To audit web accessibility, review interactive UI components to ensure they have proper screen reader roles, labels, states, and ARIA attributes. This process enforces semantic HTML structure and keyboard navigation to guarantee inclusive interactions.

What are the core principles for creating accessible UI components?

Accessible UI components rely on four core principles: structure, meaning, predictability, and visual information augmentation. These principles govern the application of semantic HTML, ARIA attributes, and keyboard accessibility to ensure inclusive user experiences.

When do I need to add ARIA attributes for keyboard accessibility?

Add ARIA attributes for keyboard accessibility when native semantic HTML does not convey the required roles, labels, or states. Use ARIA to augment visual information and ensure interactive elements are predictable and navigable for screen reader users.

Does this web accessibility guideline cover semantic HTML and screen reader states?

Yes, these web accessibility guidelines cover semantic HTML usage and screen reader states. They define a mental model for applying roles, labels, and states, providing concrete rules for structuring components and implementing accessibility review workflows.

What is the best way to implement keyboard navigation support in web components?

The best way to implement keyboard navigation is by using semantic HTML elements combined with appropriate ARIA attributes. This ensures interactive controls maintain proper roles and states, enabling predictable keyboard accessibility and screen reader compatibility.