processing-markdown — Claude Code skill: Markdown processing
processing-markdown is a Claude Code skill for querying and transforming Markdown with mq. It activates for content extraction, document changes, and mq queries.
no license 1 installs updated 2026-03-18
npx skills add DuxLocutus/ai-skills --skill processing-markdown -a claude-codeWhat processing-markdown does
The skill uses mq queries to select parts of a Markdown document and return their content or a transformed result. It can extract headings, code blocks, links, images, list items, and other nodes, then filter them with conditions.
For multiple files, mq can gather results into one array or join file contents with a separator. Options also cover in-place updates, input and output formats, runtime variables, and line-by-line processing. With HTML input through -I html, queries still use Markdown selectors such as .link or .h, not HTML tag names.
What it helps with
- extract headings or links from a Markdown file
- filter code blocks by language
- collect results from several Markdown files
Example prompts for the agent
- Use
mqto extract every heading fromREADME.md. - Find Rust code blocks in the Markdown files.
- Turn the links in
docs.mdinto text strings.
How to install processing-markdown
1Skills CLI (Vercel)
npx skills add DuxLocutus/ai-skills --skill processing-markdown -a claude-code2Manually: put the files in place
~/.claude/skills/mq/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/mq/
1Skills CLI (Vercel)
npx skills add DuxLocutus/ai-skills --skill processing-markdown -a codex2Manually: put the files in place
.agents/skills/mq/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add DuxLocutus/ai-skills --skill processing-markdown -a cursor2Manually: put the files in place
.cursor/skills/mq/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install DuxLocutus/ai-skills skills/mq2Manually: put the files in place
.github/skills/mq/SKILL.md1Skills CLI (Vercel)
npx skills add DuxLocutus/ai-skills --skill processing-markdown -a gemini-cli2Platform CLI
gemini skills install https://github.com/DuxLocutus/ai-skills --path skills/mqManually: put the files in place
.devin/skills/mq/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add DuxLocutus/ai-skills --skill processing-markdown -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about processing-markdown
How do I install processing-markdown in Claude Code?
Run npx skills add DuxLocutus/ai-skills --skill processing-markdown -a claude-code. The skill file is at ~/.claude/skills/mq/SKILL.md.
What does processing-markdown do?
It helps query Markdown with mq to extract document elements, filter them, and transform their contents.
Which selectors work with HTML input in processing-markdown?
With -I html, mq converts the input to Markdown before running a query. Use Markdown selectors such as .text, .link, or .h, rather than HTML tag names.