Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add DuxLocutus/ai-skills --skill processing-markdown -a claude-code
Open on GitHub

What 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 mq to extract every heading from README.md.
  • Find Rust code blocks in the Markdown files.
  • Turn the links in docs.md into text strings.

How to install processing-markdown

1Skills CLI (Vercel)

npx skills add DuxLocutus/ai-skills --skill processing-markdown -a claude-code

2Manually: put the files in place

~/.claude/skills/mq/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/mq/

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.

Similar skills

All skills for Writing and docs →

Project sponsors

Companies that keep this analytics open