fixing-accessibility

Audit and fix HTML accessibility issues including ARIA labels, keyboard navigation, and focus management.

Updated Mar 12, 2026
One-click install
npx skills add https://github.com/RavitejaKarra24/dotfiles --skill fixing-accessibility-ravitejakarra24
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: fixing-accessibility
Source: https://github.com/RavitejaKarra24/dotfiles/tree/main/agents/.agents/skills/fixing-accessibility
Command: npx skills add https://github.com/RavitejaKarra24/dotfiles --skill fixing-accessibility-ravitejakarra24

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Web interfaces often ship with accessibility defects—missing ARIA labels, keyboard-inaccessible controls, broken focus management, and unlinked form errors—that block users relying on assistive technologies and fail WCAG compliance reviews. ## Core Features & Use Cases - Prioritized Rule Audit: Reviews HTML against nine ranked rule categories, from accessible names and keyboard access (critical) to contrast, media, and motion. - Targeted Fix Suggestions: Reports violations with the exact offending snippet, a one-sentence impact explanation, and a minimal code-level fix rather than large rewrites. - Use Case: When adding a modal dialog or icon-only toolbar button, run the review to catch missing focus trapping, absent aria-label attributes, and unlinked form error messages before shipping. ## Quick Start Ask the assistant to review a specific HTML file for accessibility violations and propose minimal fixes using the fixing-accessibility rules.

Frequently Asked Questions about fixing-accessibility

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

FAQPage Schema
How do I fix accessibility issues in HTML forms?

Link error messages to fields using aria-describedby, set aria-invalid on invalid inputs, mark required fields so they are announced, and associate helper text with inputs. Critical errors should use aria-live regions so screen readers announce them.

How to make icon-only buttons accessible to screen readers?

Add an aria-label or aria-labelledby attribute to the button so it has an accessible name, and mark the decorative SVG icon with aria-hidden="true". Every interactive control must expose a meaningful name to assistive technologies.

What accessibility issues should be fixed first in a WCAG review?

Fix critical categories first: accessible names for controls, full keyboard access, and focus management in dialogs. Then address high-priority semantics and form errors before medium-priority items like contrast and motion preferences.

Should I use ARIA roles or native HTML elements for accessibility?

Prefer native elements like button, a, and input over role-based hacks, since they provide keyboard support and semantics by default. Only add ARIA when native semantics cannot solve the problem, and include all required attributes for any role used.

When should I not apply accessibility fixes to existing code?

Avoid large rewrites or refactoring unrelated code, and do not migrate UI libraries unless requested. The approach favors minimal, targeted fixes and established accessible primitives over custom widget behavior.