From axe-accessibility
This skill should be used when the user asks to "generate accessibility instructions", "add axe instructions to my repo", "bake a11y into my coding agent", "create copilot-instructions for accessibility", "set up CLAUDE.md for axe", or runs /axe-accessibility:mcp-generate-instructions. It writes or updates agent-instruction files (CLAUDE.md, .github/copilot-instructions.md, Cursor rules, or AGENTS.md) that enforce the axe MCP analyze -> remediate -> verify workflow.
How this skill is triggered — by the user, by Claude, or both
Slash command
/axe-accessibility:mcp-generate-instructions [targets] (optional: claude | copilot | cursor | agents | all)[targets] (optional: claude | copilot | cursor | agents | all)This skill is limited to the following tools:
The summary Claude sees in its skill listing — used to decide when to auto-load this skill
Produce agent-instruction files that make a coding agent automatically run Deque's axe MCP analyze -> remediate -> verify workflow whenever it touches UI. The goal is the same effect as a hand-written `copilot-instructions.md`: every UI change is checked and fixed against the deterministic axe engine before it is considered done.
Produce agent-instruction files that make a coding agent automatically run Deque's axe MCP analyze -> remediate -> verify workflow whenever it touches UI. The goal is the same effect as a hand-written copilot-instructions.md: every UI change is checked and fixed against the deterministic axe engine before it is considered done.
Targets and their files:
| Target | File |
|---|---|
claude | CLAUDE.md (repo root) |
copilot | .github/copilot-instructions.md |
cursor | .cursor/rules/accessibility.mdc (fallback .cursorrules) |
agents | AGENTS.md (repo root) |
If $1 specifies targets (claude, copilot, cursor, agents, or all), use them. Otherwise detect what already exists in the repo with Glob (CLAUDE.md, .github/copilot-instructions.md, .cursor/**, .cursorrules, AGENTS.md) and confirm the set with AskUserQuestion — default to the files already present, offering to add others.
Use the canonical workflow text in references/workflow-template.md as the body. Adapt the tool-name references per target — see references/targets.md for each target's tool-naming convention and any file-format specifics (e.g. Cursor .mdc frontmatter). Keep the mandatory analyze -> remediate -> verify loop, the credit-aware note, and the image-alt guidance intact across all targets.
For each target file:
Show the user a brief diff/summary of what was added or changed per file.
Inspect the repo to make the instructions concrete:
package.json scripts, README, framework config) and reference the real localhost URL in the analysis step.references/workflow-template.md. Ask the user before inventing project-specific rules.Summarize which files were written/updated and remind the user that:
.github/copilot-instructions.md, Claude Code reads CLAUDE.md, etc.)./axe-accessibility:mcp-setup) for the workflow to function./axe-accessibility:mcp-audit <url> runs the same loop on demand.references/workflow-template.md — the canonical mandatory-workflow text to embed.references/targets.md — per-target file paths, tool-naming conventions, and format notes.Guides creation, editing, and verification of skills for AI coding agents using test-driven development with subagent scenarios. Use when authoring or debugging skills.
npx claudepluginhub dequelabs/axe-accessibility --plugin axe-accessibility