Fix an accessibility issue with AI
Find the source of a confirmed barrier, make a focused repair and verify the original interaction before closing the issue.
Fix an accessibility issue with AI when you already have a reproducible failure. An error message might be visible on screen yet have no connection to the field it describes. The fix-accessibility-issue skill starts with that specific evidence and traces it back to the element or component responsible.
The repair should preserve the task for everyone who uses it. Removing the error text might silence a check while leaving the user no way to recover. The workflow favours a small source change, a repeat of the original interaction and a record of any remaining judgement or uncertainty.
What it does
- Reproduce the exact state where keyboard interaction failed.
- Trace an incorrect accessible name to its owning component or template.
- Prefer a native association when a field and its error message belong together.
- Verify focus and announcements after a change to a custom control.
- Record the source change, before-and-after evidence and any manual work that remains.
Install and use
- Provide the finding, authorised source access and a reproducible test environment. Use the project's browser or component checks as appropriate.
- Confirm the failing state, identify the owner of the behaviour and review the proposed source change.
- Repeat the original interaction and capture the result. If the state is unavailable, keep verification open.
FAQ
Source
Made by a11y-agent-skills contributors (smukh). Original skill: fix-accessibility-issue, published on GitHub under the MIT licence.
View on GitHub