Fix Broken Links
chef/chef-web-docs
Run linkchecker against a locally served site, a deployed URL, or a local HTML build output, parse the errors, map each broken link back to its Markdown source file, suggest replacement URLs, and…
Internal helper: apply approved markdown fixes, surface judgment calls.
Install Markdown Fixer
$ npx skills add Community-Access/accessibility-agents --skill markdown-fixer -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install Community-Access/accessibility-agents markdown-fixer --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/Community-Access/accessibility-agents.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/markdown-fixer .claude/skills/markdown-fixer && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "markdown-fixer" agent skill from https://github.com/Community-Access/accessibility-agents/tree/main/skills/markdown-fixer into .claude/skills/markdown-fixer/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "markdown-fixer", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/Community-Access/accessibility-agents/tree/main/skills/markdown-fixerType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add Community-Access/accessibility-agents --skill markdown-fixer -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install Community-Access/accessibility-agents markdown-fixer --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Community-Access/accessibility-agents.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/markdown-fixer .agents/skills/markdown-fixer && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "markdown-fixer" agent skill from https://github.com/Community-Access/accessibility-agents/tree/main/skills/markdown-fixer into .agents/skills/markdown-fixer/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "markdown-fixer", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add Community-Access/accessibility-agents --skill markdown-fixer -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install Community-Access/accessibility-agents markdown-fixer --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Community-Access/accessibility-agents.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/markdown-fixer .cursor/skills/markdown-fixer && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "markdown-fixer" agent skill from https://github.com/Community-Access/accessibility-agents/tree/main/skills/markdown-fixer into .cursor/skills/markdown-fixer/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "markdown-fixer", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/Community-Access/accessibility-agents.git --path skills/markdown-fixer--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add Community-Access/accessibility-agents --skill markdown-fixer -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install Community-Access/accessibility-agents markdown-fixer --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Community-Access/accessibility-agents.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/markdown-fixer .gemini/skills/markdown-fixer && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "markdown-fixer" agent skill from https://github.com/Community-Access/accessibility-agents/tree/main/skills/markdown-fixer into .gemini/skills/markdown-fixer/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "markdown-fixer", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install Community-Access/accessibility-agents markdown-fixerInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add Community-Access/accessibility-agents --skill markdown-fixer -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/Community-Access/accessibility-agents.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/markdown-fixer .github/skills/markdown-fixer && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "markdown-fixer" agent skill from https://github.com/Community-Access/accessibility-agents/tree/main/skills/markdown-fixer into .github/skills/markdown-fixer/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "markdown-fixer", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add Community-Access/accessibility-agents --skill markdown-fixer -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install Community-Access/accessibility-agents markdown-fixer --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Community-Access/accessibility-agents.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/markdown-fixer .opencode/skills/markdown-fixer && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "markdown-fixer" agent skill from https://github.com/Community-Access/accessibility-agents/tree/main/skills/markdown-fixer into .opencode/skills/markdown-fixer/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "markdown-fixer", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
markdown-fixer- GitHub stars
- 421
- Token cost
- ~1.6k tokens
- SKILL.md length
- 635 words
- Files
- 3 (incl. references)
- Skills in repo
- 108
- Repo updated
- First seen
- Licence
- MIT
At a glance
Internal helper: apply approved markdown fixes, surface judgment calls.
- Works in 4 steps: The structured scan report from… → The approved issue list (which to… → Phase 0 preferences (emoji mode, dash… → …
- Tasks that involve Markdown
- SKILL.md covers Markdown Fixer, Input, Fix Categories and Output Format, plus 3 more sections
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
What it does
Markdown Fixer is an agent skill from Community-Access/accessibility-agents. Internal helper: apply approved markdown fixes, surface judgment calls.
Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including reference files (for example `agents/openai.yaml` and `references/fix-rules.md`).
It sits in Documents & Office, covering Markdown. The repository describes itself as: Accessibility review agents for Claude Code, GitHub Copilot, and Claude Desktop. Eleven specialists that enforce WCAG 2.2 AA compliance so AI coding tools stop generating… The licence is MIT.
When your agent uses it
- Tasks that involve Markdown
Example prompts
- “/markdown-fixer”
Workflow steps
4 steps, taken from the first numbered list in SKILL.md.
- The structured scan report from markdown-scanner
- The approved issue list (which to auto-fix vs. which to present for review)
- Phase 0 preferences (emoji mode, dash mode, Mermaid mode, ASCII mode)
- The full file path
What it can do on your machine
Read from SKILL.md and the folder at commit decf6ba. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown).
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Markdown Fixer loads about 1.6k tokens when it runs, and up to ~2.3k if it reads all its reference files. Until then it costs about 22 tokens; SKILL.md has 635 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from Community-Access/accessibility-agents at commit decf6ba, republished under its MIT licence (© Community-Access). 635 words, ~1,606 tokens.
Download SKILL.mdSave it as
.claude/skills/markdown-fixer/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.- name
- markdown-fixer
- description
- Internal helper: apply approved markdown fixes, surface judgment calls.
- license
- MIT
- disable-model-invocation
- true
- user-invocable
- false
- metadata.tier
- helper
- metadata.domain
- markdown
- metadata.output
- artifact
- metadata.effort
- low
- metadata.title
- Markdown Fixer
Markdown Fixer
You are a markdown accessibility fixer. You receive a structured issue list from markdown-scanner and apply fixes to markdown files.
You do NOT scan files. You receive pre-classified issues and apply them.
Input
You will receive:
- The structured scan report from
markdown-scanner - The approved issue list (which to auto-fix vs. which to present for review)
- Phase 0 preferences (emoji mode, dash mode, Mermaid mode, ASCII mode)
- The full file path
Fix Categories
Auto-Fixable (apply without asking)
Each domain, with its issue and fix.
| Domain | Issue | Fix |
|---|---|---|
| Descriptive links | Ambiguous text with surrounding context available | Rewrite using sentence context |
| Descriptive links | Bare URL in prose | Wrap with descriptive text from URL path |
| Heading hierarchy | Multiple H1s | Demote all but first to H2 |
| Heading hierarchy | Skipped heading level | Interpolate the missing level |
| Heading hierarchy | Bold text used as visual heading | Convert to appropriate heading element |
| Tables | Missing preceding description | Prepend one-sentence summary from column headers |
| Tables | Empty first header cell | Add "Item" or infer from context |
| Emoji (remove-all) | Any emoji anywhere | Remove; preserve meaning in adjacent text |
| Emoji (remove-decorative) | Emoji in headings | Remove from heading text |
| Emoji (remove-decorative) | Emoji as bullet (first char of list item) | Remove; keep remaining text |
| Emoji (remove-decorative) | Consecutive emoji (2+) | Remove the entire sequence |
| Emoji (translate) | Known emoji | Replace with (Translation) |
| Mermaid (replace-with-text) | Simple diagram with auto-generated description | Description + <details> wrapping original |
| ASCII (replace-with-text) | ASCII diagram with auto-generated description | Description + <details> wrapping original |
| Em-dash (normalize) | Em-dash, en-dash, --, --- in prose | Replace per dash preference |
Human-Judgment (present for confirmation, do not auto-apply)
Each domain, with why human needed.
| Domain | Why Human Needed |
|---|---|
| Alt text content for images | Only the author knows the image's purpose |
| Mermaid complex diagrams | Description draft needs author verification |
| ASCII art diagrams | Description must be provided or approved |
| Plain language rewrites | Requires understanding audience, tone, intent |
| Link rewrites with insufficient surrounding context | Cannot determine correct destination text |
| Heading demotions affecting document structure | May require broader restructuring |
| Unknown emoji in translate mode | Translation cannot be inferred |
Output Format
For each file processed, return:
## Fix Report: <filename>
### Applied Fixes ([N] total)
| # | Domain | Line | Change | Before | After |
|---|--------|------|--------|--------|-------|
| 1 | Emoji | 12 | Removed emoji from heading | `## 🚀 Quick Start` | `## Quick Start` |
| 2 | Em-dash | 34 | Normalized em-dash | `agent—invoked` | `agent - invoked` |
| 3 | Table | 88 | Added description | *(none)* | "The following table lists..." |
| 4 | Mermaid | 56 | Replaced with text + details | ` ```mermaid...` | "[description]\n<details>..." |
| 5 | ASCII | 71 | Wrapped in details + description | *(ASCII art block)* | "[description]\n<details>..." |
### Presented for Human Review ([N] items)
For each review item, present:
---
**[Issue Type] - Line [N]**
Current:[quoted content]
Problem: [specific accessibility impact]
Suggested fix:[proposed content]
Why this matters: [which users are affected and how]
Apply this fix? (Yes / No / Edit suggestion)
---
### File Status
- **Before:** [N] issues | **Score:** [before]
- **After:** [N] remaining | **Score:** [after]
- **Fixed:** [N auto] + [N after review]Multi-Agent Reliability
Role
You are a state-changing agent. You modify markdown files to fix accessibility issues. Every modification requires prior user confirmation through the review gate.
Show full SKILL.md (263 more words)Show less
Action Constraints
You may:
- Apply auto-fixable changes (ambiguous links, heading hierarchy, em-dashes, emoji removal/translation, table descriptions, anchor fixes) ONLY after the review gate
- Present human-judgment items for user decision (alt text content, plain language rewrites)
- Report before/after state for each file
You may NOT:
- Apply any fix before the Phase 3 review gate is completed
- Auto-fix alt text content (requires visual judgment)
- Auto-fix plain language rewrites (requires author intent)
- Modify code blocks, inline code, or YAML front matter
- Modify files outside the scope provided by
markdown-a11y-assistant
Output Contract
For each fix applied, return:
action: what was changedtarget: file path and line numberresult:success|skipped|needs-reviewreason: explanation (required if result is notsuccess)
File summary MUST include before/after issue count and score.
Handoff Transparency
When invoked by markdown-a11y-assistant:
- Announce start: "Applying [N] approved fixes to [filename] ([N] auto-fixable, [N] human-judgment)"
- Per fix: Show before/after with accessibility impact explanation
- Announce completion: "Fix pass complete for [filename]: [N] applied, [N] skipped, [N] need review. Score: [before] -> [after]"
- On failure: "Fix failed for [target]: [reason]. File left unchanged. Presenting for manual resolution."
You return results to markdown-a11y-assistant. Users see each fix with an approval prompt before it is applied.
Reference files
Read one only when the task reaches it. Do not read them all up front.
references/fix-rules.md- Fix Rules
Output contract
Produce the file or script the task asks for. Report what you wrote as a short list of paths and what each one changes. Do not restate the file contents.
Shared rules, dispatch contract and schemas: skills/a11y-core/SKILL.md.
Authoritative specifications for this skill: skills/a11y-core/references/sources.md.
© Community-Access, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
SKILL.md and 2 other files (references) in skills/markdown-fixer of Community-Access/accessibility-agents.
- SKILL.md
- agents/openai.yaml
- references/fix-rules.md
Open the folder on GitHubat commit decf6ba
Compare with similar skills
Markdown Fixer next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Markdown Fixer this skillCommunity-Access/accessibility-agents | 421 | — | ~1.6k | Automated safety check: Pass | MIT | |
| Fix Broken Linkschef/chef-web-docs | 143 | — | ~3.2k | Automated safety check: Pass | Custom licence | |
| Dile Docs PagesPolydile/dile-components | 106 | — | ~2.8k | Automated safety check: Pass | MIT | |
| Write Documentdigital-go-jp/design-system-example-components-html | 112 | — | ~3.1k | Automated safety check: Pass | MIT | |
| Publish Skillglebis/claude-skills | 388 | — | ~4.1k | Automated safety check: Pass | MIT | |
| YAML Agent FormatMadAppGang/claude-code | 283 | — | ~4.8k | Automated safety check: Pass | MIT |
Similar skills
Dile Docs Pages
Polydile/dile-components
A skill your agent uses when creating or updating a Markdown documentation page of the Dile Components Eleventy site under docs/ — especially component pages in docs/components/.md, but also…
Write Document
digital-go-jp/design-system-example-components-html
コンポーネントのMDXドキュメントを作成・更新する
Publish Skill
glebis/claude-skills
This skill should be used when publishing a new or updated skill to the claude-skills-site Astro website.
YAML Agent Format
MadAppGang/claude-code
YAML format for Claude Code agent definitions as alternative to markdown.
Fern Components
ai-dynamo/dynamo
Knowledge of Fern's built-in MDX component library (accordions, callouts, cards, steps, tabs, code blocks, API-reference snippets, and more) for authoring docs pages.
More from Community-Access/accessibility-agents
All 108 skills in this repoA11y Core
Community-Access/accessibility-agents
Shared contract for the Accessibility Agents skills - dispatch, findings schema, report rules.
Kb Web Scanning
Community-Access/accessibility-agents
Reference data, not a reviewer. An agent skill from Community-Access/accessibility-agents.
Accessibility Lead
Community-Access/accessibility-agents
Web UI accessibility lead. An agent skill from Community-Access/accessibility-agents.
Alt Text Headings
Community-Access/accessibility-agents
Alt text, SVGs, figures, charts, heading order, page titles and landmarks.
Aria Specialist
Community-Access/accessibility-agents
ARIA roles, states and properties for custom widgets and dynamic content.
Cognitive Accessibility
Community-Access/accessibility-agents
Plain language, WCAG 2.2 cognitive criteria, COGA guidance and auth UX.
Related
Categories
Questions about Markdown Fixer
What does Markdown Fixer do?
Internal helper: apply approved markdown fixes, surface judgment calls. Markdown Fixer is an agent skill from Community-Access/accessibility-agents. Internal helper: apply approved markdown fixes, surface judgment calls.
When should I use Markdown Fixer?
Markdown Fixer fits situations like: tasks that involve Markdown.
How do I install Markdown Fixer in Claude Code?
Run `npx skills add Community-Access/accessibility-agents --skill markdown-fixer -a claude-code`. Or copy the skill folder (skills/markdown-fixer in Community-Access/accessibility-agents) into .claude/skills/markdown-fixer in your project. Claude Code loads it when a task matches its description.
How do I install Markdown Fixer in Codex?
Run `npx skills add Community-Access/accessibility-agents --skill markdown-fixer -a codex`. Or copy the skill folder (skills/markdown-fixer in Community-Access/accessibility-agents) into .agents/skills/markdown-fixer in your project. Codex loads it when a task matches its description.
Can I use Markdown Fixer in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Community-Access/accessibility-agents --skill markdown-fixer -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/markdown-fixer, .gemini/skills/markdown-fixer, .github/skills/markdown-fixer and .opencode/skills/markdown-fixer in your project.
What does Markdown Fixer need to run?
SKILL.md names no scripts, command-line tools or credentials: Markdown Fixer is instructions for the agent only.
Does Markdown Fixer access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Markdown Fixer safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Markdown Fixer use?
Markdown Fixer is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Markdown Fixer use?
About 1.6k tokens (SKILL.md is roughly 6.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 717 tokens, read only when the agent opens those files.
What are the alternatives to Markdown Fixer?
Skills that share tags, products or a category with Markdown Fixer: Fix Broken Links (chef/chef-web-docs, 143 stars), Dile Docs Pages (Polydile/dile-components, 106 stars), Write Document (digital-go-jp/design-system-example-components-html, 112 stars) and Publish Skill (glebis/claude-skills, 388 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Markdown Fixer?
Community-Access (a GitHub organization) maintains it in Community-Access/accessibility-agents, which has 421 GitHub stars. The repository holds 108 skills in this directory. The repository was last updated on September 23, 2026.
Source: Community-Access/accessibility-agents on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.