fixing-accessibility

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

Updated Aug 13, 2026
One-click install
npx skills add https://github.com/Mjlike123/ui-prototype-workbench --skill fixing-accessibility-mjlike123
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: fixing-accessibility
Source: https://github.com/Mjlike123/ui-prototype-workbench/tree/main/.agents/skills/fixing-accessibility
Command: npx skills add https://github.com/Mjlike123/ui-prototype-workbench --skill fixing-accessibility-mjlike123

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Interactive UI code often ships with accessibility defects such as unlabeled icon buttons, keyboard-inaccessible controls, broken focus handling in dialogs, and form errors that screen readers cannot announce. This Skill audits HTML against WCAG-oriented rules and proposes minimal, targeted fixes. ## Core Features & Use Cases - Rule-based audit: Reviews files against nine prioritized rule categories covering accessible names, keyboard access, focus and dialogs, semantics, forms and errors, announcements, contrast, media, and tool boundaries. - Concrete fix suggestions: Reports violations with the exact offending snippet, a one-sentence rationale, and a code-level fix, favoring native HTML elements over ARIA workarounds. - Use Case: When adding a modal dialog or a form with validation, run the review to catch missing aria-describedby links, absent focus trapping, or div-based buttons before shipping. ## Quick Start Ask the assistant to review a specific HTML or component file for accessibility violations and suggest 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 with aria-describedby, set aria-invalid on invalid inputs, mark required fields so they are announced, and associate helper text with inputs. The Skill reviews these patterns and suggests minimal code-level fixes.

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 inner SVG as aria-hidden="true" since it is decorative. Every interactive control must expose a name to assistive technology.

Should I use ARIA roles or native HTML elements?

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

What keyboard and focus rules apply to modal dialogs?

Modals must trap focus while open, set initial focus inside the dialog, restore focus to the trigger on close, and close on Escape. Opening a dialog should not unexpectedly scroll the page.

When should I not apply accessibility fixes with this approach?

Avoid large rewrites, unrelated refactors, or migrating UI libraries unless requested. The guidance favors minimal targeted fixes and established accessible primitives for complex widgets like menus and comboboxes.