Can it fix image alt-text without my input?

No. Because alt-text requires understanding the author's intent, the skill flags missing alt-text and presents a suggested fix for human approval rather than auto-applying it.

How does it handle complex Mermaid or ASCII diagrams?

It generates a descriptive text summary for the diagram and wraps the original source in a block, ensuring the content is accessible to screen readers while remaining available to sighted users.

Does it support the latest WCAG standards?

Yes, the Markdown Accessibility Fixer is specifically designed to enforce WCAG 2.2 AA compliance patterns.

Does this skill modify my files automatically?

While it identifies auto-fixable issues, it operates as a state-changing agent that requires user confirmation through a review gate before any modifications are written to your files.

What happens to emojis in my Markdown files?

Depending on your preference, the skill can remove all emojis, remove only decorative ones from headings and lists, or translate them into parenthetical text descriptions.

Markdown Accessibility Fixer

Name: Markdown Accessibility Fixer
Author: Community-Access

byCommunity-Access

•

259

•

Content Management

Remediates WCAG 2.2 AA accessibility violations in Markdown files by automatically fixing links, headings, tables, and complex diagrams.

The Markdown Accessibility Fixer is a specialized agent designed to bridge the gap between AI-generated content and digital inclusion. It processes accessibility scan reports to resolve common barriers such as ambiguous link text, broken heading hierarchies, and missing table descriptions. For complex elements like Mermaid diagrams or ASCII art, it generates descriptive text and wraps source code in accessible disclosure widgets. By integrating directly into the Claude Code workflow, it ensures your project documentation is compliant with WCAG 2.2 AA standards while maintaining a transparent, human-in-the-loop review process for subjective content like image alt-text.

Key Features

01Batch-processing engine that applies all file changes in a single efficient pass

02Accessibility wrapping for Mermaid and ASCII diagrams with text alternatives

03259 GitHub stars

04Automated restoration of heading hierarchies and link text optimization

05Automatic generation of accessible table summaries based on column data

06Smart emoji management via removal or translation into descriptive text

Use Cases

01Ensuring technical documentation and READMEs meet WCAG 2.2 AA compliance

02Refactoring legacy Markdown files to fix skipped heading levels and bare URLs

03Converting visual-only Mermaid diagrams into screen-reader friendly formats

Key Features

01Batch-processing engine that applies all file changes in a single efficient pass

02Accessibility wrapping for Mermaid and ASCII diagrams with text alternatives

03259 GitHub stars

04Automated restoration of heading hierarchies and link text optimization

05Automatic generation of accessible table summaries based on column data

06Smart emoji management via removal or translation into descriptive text

Use Cases

01Ensuring technical documentation and READMEs meet WCAG 2.2 AA compliance

02Refactoring legacy Markdown files to fix skipped heading levels and bare URLs

03Converting visual-only Mermaid diagrams into screen-reader friendly formats