Kb Markdown Accessibility

Reference data, not a reviewer. Audit and fix markdown for accessibility. Covers ambiguous links, anchors, emoji (remove/translate), Mermaid/ASCII templates, heading hierarchy, table descriptions, and severity scoring.

449 stars 54 forksFrontend & Design 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 kb-markdown-accessibility
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/kb-markdown-accessibility ~/.claude/skills/kb-markdown-accessibility

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

From the SKILL.md

## Markdown Accessibility Skill

Reusable knowledge module for the `markdown-a11y-assistant`, `markdown-scanner`, and `markdown-fixer` skills. Provides pattern libraries, severity scoring, fix templates, emoji translation maps, diagram description templates, and GitHub anchor generation rules for comprehensive markdown accessibility auditing across 9 domains.

## Domains Covered

1. **Descriptive Links** (WCAG 2.4.4) - Ambiguous link text, bare URLs, repeated identical text
2. **Image Alt Text** (WCAG 1.1.1) - Missing, empty, filename-as-alt, generic placeholders
3. **Heading Hierarchy** (WCAG 1.3.1 / 2.4.6) - Skipped levels, multiple H1s, bold-as-heading
4. **Table Accessibility** (WCAG 1.3.1) - Missing descriptions, empty headers, layout tables
5. **Emoji** (WCAG 1.3.3 / Cognitive) - Remove-all, remove-decorative, translate, or leave-unchanged modes
6. **Mermaid and ASCII Diagrams** (WCAG 1.1.1 / 1.3.1) - Replace with accessible text + collapsible source
7. **Em-Dash / En-Dash Normalization** (Cognitive) - Normalize to ` - ` or leave unchanged
8. **Anchor Link Validation** (WCAG 2.4.4) - Validate `#anchor` links against actual headings
9. **Plain Language and List Structure** (Cognitive) - Emoji bullets, passive voice, sentence length

## Severity Scoring

Each issue, with its severity, WCAG and auto-fix.

| Issue | Severity | WCAG | Auto-fix? |
|-------|----------|------|-----------|
| Image missing alt text | critical | 1.1.1 (A) | No - needs visual judgment |
Read the full skill on GitHub

Details

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

FAQ

What does the Kb Markdown Accessibility skill do?

Reference data, not a reviewer. Audit and fix markdown for accessibility. Covers ambiguous links, anchors, emoji (remove/translate), Mermaid/ASCII templates, heading hierarchy, table descriptions, and severity scoring.

How do I install the Kb Markdown Accessibility 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 Kb Markdown Accessibility 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 frontend & design skills, or write your own with the skills generator.