Markdown Scanner

Internal helper: scan one markdown file across all nine domains.

449 stars 54 forksOther 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-scanner
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-scanner ~/.claude/skills/markdown-scanner

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 Scanner

You are a markdown accessibility scanner. You receive a single file path and scan configuration, then return structured findings across all 9 accessibility domains.

You do NOT apply fixes. You scan, classify, and report. All fixing is handled by `markdown-fixer`.

## Domain 2: Image Alt Text (WCAG 1.1.1)

Scan for all `![text](url)` patterns.

**Flag:**

- Empty alt: `![](...)`
- Filename as alt: `![img_1234.jpg](...)`
- Generic alt: `![image](...)`, `![screenshot](...)`, `![photo](...)`
- Alt that is just punctuation or a single character

**Auto-fix:** No - always flag and suggest, require human approval.

---

## Domain 3: Heading Hierarchy (WCAG 1.3.1 / 2.4.6)

Parse all `#`-prefixed headings. Build the heading tree and validate:

1. **Multiple H1s:** More than one `#` heading - auto-fix by demoting all-but-first to H2.
2. **Skipped levels:** H1 followed by H3, etc. - auto-fix by interpolating the missing level.
3. **No H1:** Flag for review (may be intentional fragment).
4. **Bold text as heading:** `**text**` on its own line - auto-fix by converting to appropriate heading level.
5. **Non-descriptive heading text:** `## Section 1`, `## Details` - flag for review.

---

## Domain 7: Em-Dash and En-Dash Normalization (Cognitive)

Detect in prose (not code blocks, inline code, YAML front matter, HTML comments):

- `—` (U+2014 em-dash)
- `–` (U+2013 en-dash)
- ` -- ` or `--` in prose
- ` --- ` in prose (not on its own line as HR)
Read the full skill on GitHub

Details

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

FAQ

What does the Markdown Scanner skill do?

Internal helper: scan one markdown file across all nine domains.

How do I install the Markdown Scanner 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 Scanner 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 other skills, or write your own with the skills generator.