Web Accessibility
Designweb-accessibilityWeb Accessibility is an Agent Skill for design published in the Community-Access/accessibility-agents repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Use for web accessibility work in HTML, JSX, CSS, ARIA, keyboard, forms, contrast, modals, live regions, headings, links, tables, or WCAG review; starts accessibility-lead first and uses tool_search if subagent tools are lazy-loaded.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/Community-Access/accessibility-agents/blob/HEAD/codex-plugin/skills/web-accessibility/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/web-accessibility, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Web Accessibility Router
Use this skill for web UI accessibility work in Codex.
Installing Accessibility Agents for Codex is the user's standing request to use
the Accessibility Agents subagent workflow for accessibility work. Treat every
user-facing web accessibility task as authorized to spawn accessibility-lead
unless the user explicitly asks for a single-agent pass.
Workflow
- Explicitly spawn
accessibility-leadas a Codex custom subagent for every user-facing web accessibility task. Do not satisfy this step by reading the lead reference inline. The lead coordinates the same specialist team used by Claude Code. - If
multi_agent_v1.spawn_agentis not already in the active tool list, calltool_searchformulti-agent subagent accessibilitybefore saying subagents are unavailable. Do not downgrade to local-only review just because the spawn tool was lazy-loaded. - If tool discovery still does not expose
multi_agent_v1.spawn_agent, stop and ask the user to enable subagents/Accessibility Agents before continuing, unless the user explicitly authorizes a local fallback. - When spawning any named Accessibility Agents Codex subagent, do not request a full-history fork. Pass the task context explicitly so Codex can use the selected custom agent type without inheriting the parent agent type.
- Pass skill context to every spawned Accessibility Agents subagent. Include this skill as an item when possible:
{ "type": "skill", "name": "web-accessibility", "path": "/Users/taylorarndt/.agents/skills/web-accessibility/SKILL.md" }. Also include the relevant specialist reference path or excerpt when the task depends on a specialist workflow. - Read
codex-plugin/references/specialists/accessibility-lead.mdandcodex-plugin/references/specialists/index.jsonwhen available. In installed Codex plugin layouts, use.agents/plugins/a11y-agents-codex/references/specialists/or~/.agents/plugins/a11y-agents-codex/references/specialists/. Use the lead decision matrix and the index to select relevant specialist references and Codex subagents. - Identify the task domain: semantics, ARIA, keyboard, forms, contrast, overlays, live updates, headings, links, tables, mobile web, or full audit.
- Check installed Accessibility Agents extensions before finalizing dispatch. Look for extension manifests under
.a11y-agents/extensions/,~/.a11y-agents/extensions/, and this plugin'sextensions/directory. - Dispatch matching Codex custom subagents by default for reviews, audits, new UI, changed UI, and PR accessibility checks. Do not make users manually name every specialist.
- If nested dispatch is unavailable inside
accessibility-lead, the root session must spawnaccessibility-leadand the selected specialists directly, then ask the lead to synthesize the results. - Wait for
accessibility-leadand every selected specialist to complete before giving the user a final answer. Do not treat a started lead as a completed review. - The lead synthesizes specialist output: deduplicate, resolve conflicts, assign severity, map to WCAG/public standards or extension rules, and make a ship/no-ship call.
- Label extension findings with the extension name.
Default Subagent Dispatch
- Broad audit:
accessibility-lead,aria-specialist,keyboard-navigator,contrast-master,forms-specialist,modal-specialist,live-region-controller,alt-text-headings,tables-data-specialist,link-checker - New UI:
accessibility-lead,aria-specialist,keyboard-navigator,alt-text-headings, plus domain specialists for forms, contrast, modals, live regions, tables, links, media, mobile, i18n, or cognitive accessibility as needed - Changed UI:
accessibility-lead,keyboard-navigator, plus any specialists matching the diff - PR review:
pr-reviewplus any web specialists matching the diff - Small fix:
accessibility-leadplus the single most relevant specialist, followed by the lead final checklist - New modal/dialog/overlay:
accessibility-lead,modal-specialist,keyboard-navigator,aria-specialist, andalt-text-headings
Do not expose all specialists as top-level skills. Keep the router surface small and load deep instructions lazily.