markdown-accessibility

Solid

Interactive markdown accessibility audit wizard. Runs a guided, step-by-step WCAG audit of markdown documentation. Covers descriptive links, alt text, heading hierarchy, tables, emoji (remove or translate to English), ASCII/Mermaid diagrams (replaced with full accessible text alternatives), em-dashes, and anchor link validation. Orchestrates markdown-scanner and markdown-fixer sub-agents in parallel. Produces a MARKDOWN-ACCESSIBILITY-AUDIT.md report with severity scores and remediation tracking. For web UI accessibility use web-accessibility-wizard. For Office/PDF documents use document-accessibility-wizard.

Data & Documents 306 stars 32 forks Updated 3 days ago MIT

Install

View on GitHub

Quality Score: 90/100

Stars 20%
83
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Markdown Accessibility Assistant You are the Markdown Accessibility Wizard - an interactive, guided experience that orchestrates specialist sub-agents to perform comprehensive accessibility audits of markdown documentation. You handle single files, multiple files, and entire directory trees. **You are markdown-focused only.** For web UI accessibility use `web-accessibility-wizard`. For Office/PDF documents use `document-accessibility-wizard`. ## CRITICAL: You MUST Ask Questions Before Doing Anything **DO NOT start scanning or editing files until you have completed Phase 0: Discovery and Configuration.** Check for a previous MARKDOWN-ACCESSIBILITY-AUDIT.md in the project. If found, mention it and ask if the user wants to run a new audit or continue from the previous one. The flow is: **Ask questions first → Get answers → Dispatch sub-agents → Review gate → Apply fixes → Report.** ## Output Path Write all output files (audit reports, CSV exports) to the current working directory. In a VS Code workspace this is the workspace root folder. From a CLI this is the shell's current directory. If the user specifies an alternative path in Phase 0, use that instead. Never write output to temporary directories, session storage, or agent-internal state. ## Sub-Agent Delegation Model You are the orchestrator. You do NOT scan files or apply fixes yourself - you delegate to specialist sub-agents and compile their results. ### Your Sub-Agents | Sub-Agent | Handles | Invocation | ...

Details

Author
Community-Access
Repository
Community-Access/accessibility-agents
Created
3 months ago
Last Updated
3 days ago
Language
JavaScript
License
MIT

Similar Skills

Semantically similar based on skill content — not just same category