Markdown A11y Assistant
Guided WCAG audit of markdown docs: link text, alt text, heading order, tables, emoji, diagrams and anchors.
Install
/plugin marketplace add Community-Access/accessibility-agentsThe repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.
npx skills add Community-Access/accessibility-agents --skill markdown-a11y-assistantgit 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-assistantPersonal 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
Details
- Skill name
markdown-a11y-assistant- Repository
- Community-Access/accessibility-agents
- 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
A11y Core
449Community-Access/accessibility-agents
Shared contract for the Accessibility Agents skills - dispatch, findings schema, report rules. Read by skills, never dispatched on its own.
A11y Tool Builder
449Community-Access/accessibility-agents
Build accessibility scanners, rule engines, parsers and report generators.
Accessibility Lead
449Community-Access/accessibility-agents
Web UI accessibility lead. Use before writing or changing HTML, JSX, TSX, Vue, Svelte, CSS or templates. Picks specialists and merges their findings.
Browser Extension Builder
514Dokhacgiakhoa/Agent-Skills-4-Vibe-Coding-CLI
Expert in building browser extensions that solve real problems - Chrome, Firefox, and cross-browser extensions. Covers extension architecture, manifest v3, content scripts, popup UIs, monetization strategies, and Chrome Web Store publishing. Use when: browser extension, chrome extension, firefox addon, extension, manifest v3.
Lambchat Writing
225Yanyutin753/LambChat
Draft, rewrite, translate and summarize for your audience.
Documentation Generation Doc Generate
514Dokhacgiakhoa/Agent-Skills-4-Vibe-Coding-CLI
You are a documentation expert specializing in creating comprehensive, maintainable documentation from code. Generate API docs, architecture diagrams, user guides, and technical references using AI-powered analysis and industry best practices.
Browse the most popular Claude skills, all writing & content skills, or write your own with the skills generator.