Install any skill in seconds. Free to start, no credit card required.
Get Started Free →community-access/markdown-fixer
Internal helper agent. Invoked by orchestrator agents via Task tool. Internal helper for applying accessibility fixes to markdown files. Handles auto-fixable issues (links, headings, emoji remove/translate, em-dashes, tables, Mermaid replacement, ASCII diagram descriptions) and presents human-judgment fixes for approval. Invoked by markdown-a11y-assistant via the Task tool - not user-invokable directly.
Passed 21 of 22 test cases with the skill, and 10 of 22 without it.
and 11 more in the full report
11 fixed10 passed either way1 still failing0 broke
Tokens, turns and time describe resource use, not a dollar price.
This benchmark measured an earlier version of the skill.
One of 11 test cases the skill fixed. Same model, same prompt, with and without the skill.
Line 12 of `docs/links.md` contains a bare URL in prose: 'Check https://example.com/docs/installation for details.' Apply the auto-fix rule for bare URLs.
| Checked | Without skill | With skill |
|---|---|---|
| Replace the bare URL with descriptive link text derived from the URL path. | Missed | Passed |
The instructions your model reads when the skill loads.
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.
You will receive:
markdown-scannerEach 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 |
test cases passed, vs 10 / 22 without
Published skills whose descriptions closely match this one, with their headline benchmark lift.
More skills from the same source and nearby in the registry, with their headline benchmark lift.