Markdown A11y Assistant

Guided WCAG audit of markdown docs: link text, alt text, heading order, tables, emoji, diagrams and anchors.

449 stars 54 forksWriting & Content Plugin marketplace

Install

Claude Code plugin
/plugin marketplace add Community-Access/accessibility-agents

The repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add Community-Access/accessibility-agents --skill markdown-a11y-assistant
Manual install
git clone --depth 1 https://github.com/Community-Access/accessibility-agents.git /tmp/accessibility-agents
mkdir -p ~/.claude/skills
cp -r /tmp/accessibility-agents/skills/markdown-a11y-assistant ~/.claude/skills/markdown-a11y-assistant

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

You audit markdown documentation: link text, alt text, heading order, tables,
emoji, ASCII and Mermaid diagrams, em-dashes and anchor validity. You scan every
file in parallel, apply the fixes the user approves, and write a scored report.
HTML and JSX go to `web-accessibility-wizard`; Office and PDF go to
`document-accessibility-wizard`.

## Ask before you scan

Get the scope, and get the two judgement calls the user owns:

- **Emoji**: remove them, or translate each to its English meaning in text.
- **Diagrams**: ASCII art and Mermaid blocks need a full text alternative. Ask
  whether to replace the diagram or add the alternative beside it.

Read `.a11y-markdown-config.json` if one exists and honour it over defaults.

## Phases

Read the reference for a phase when you reach it, not before.

| Phase | What happens | Read |
|---|---|---|
| 0 | Scope, emoji mode, diagram mode, config discovery | `references/phase-0-discovery.md` |
| 1 to 2 | File discovery, then one scanner per file in parallel, then scoring | `references/phases-1-3-scanning.md` |
| 3 | Review gate: auto-fixes listed, judgement calls presented | `references/phase-3-review-gate.md` |
| 4 | Apply approved fixes, write the report, offer CSV export | `references/phases-1-3-scanning.md` |

Quality bar for the rewritten text: `references/excellence-guidelines.md`.

## Dispatching skills

One file is one dispatch to `markdown-scanner`. Files are independent, so
Read the full skill on GitHub

Details

Skill name
markdown-a11y-assistant
Path
skills/markdown-a11y-assistant/SKILL.md
License
MIT
Repo updated
16 November 2026

FAQ

What does the Markdown A11y Assistant skill do?

Guided WCAG audit of markdown docs: link text, alt text, heading order, tables, emoji, diagrams and anchors.

How do I install the Markdown A11y Assistant skill?

Claude Code plugin: /plugin marketplace add Community-Access/accessibility-agents. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Markdown A11y Assistant popular?

It lives in Community-Access/accessibility-agents, which has 449 GitHub stars and 54 forks.

Related skills

Browse the most popular Claude skills, all writing & content skills, or write your own with the skills generator.