Does mq support Markdown tables?

Absolutely, mq can extract table data directly, making it easy to process documentation data without manual parsing.

Why use mq instead of the standard Read command?

Use mq for large files (>50 lines) to save context tokens by only pulling specific parts like headers or code blocks instead of the whole file.

Can it handle metadata?

Yes, mq can extract YAML frontmatter which can then be piped to tools like yq for JSON conversion.

Can mq extract code for specific languages?

Yes, you can use selectors like '.code("rust")' to pull only the code examples relevant to your current task.

What file types does mq work best with?

It is ideal for READMEs, CHANGELOGs, GitHub wikis, technical specifications, and any documentation-heavy Markdown files.

Markdown Query & Extraction

Name: Markdown Query & Extraction
Author: kylesnowschwartz

bykylesnowschwartz

•

Learning & Documentation

Extracts specific elements like code blocks, links, and tables from Markdown files to minimize context usage and improve efficiency.

The mq skill is a specialized Markdown query tool designed to optimize how Claude interacts with large documentation files. By extracting only necessary components—such as headers, specific code snippets, or data tables—it reduces context window consumption by up to 95%. This enables faster processing and more focused AI-assisted programming by avoiding the overhead of reading massive READMEs or technical specifications when only a subset of information is required.

Key Features

01YAML frontmatter parsing for metadata analysis

02Filtering of headers by specific levels (e.g., h1, h2, h3)

03Targeted extraction of code blocks by language identifier

0491 GitHub stars

05URL and link metadata retrieval without full-text loading

06Direct extraction of Markdown table data and lists

Use Cases

01Pulling specific API code examples from a massive project README

02Auditing all external links in a documentation folder for broken references

03Summarizing document structure by extracting only the heading hierarchy

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add kylesnowschwartz/simpleclaude mq

For use in Claude.ai and ChatGPT

Download Skill