skilld
All skills
oaustegard avatar

/querying-markdown

@4b31e7d
by Oskar Austegardoaustegard/claude-skills150 stars
6

Query, filter, and transform Markdown structurally with mq — a jq-like CLI for Markdown. Use to extract headings/sections/code-blocks/links from .md files, build a table of contents, pull code blocks of a given language, slice or reshape LLM prompt/output Markdown, or batch-transform docs. Triggers on "extract sections from this markdown", "get all the code blocks", "jq for markdown", "mq", or any structural query over Markdown that grep/Read can't do cleanly.

Ask your Agent

Use this Skill: https://skilld.dev/gh/oaustegard/claude-skills/querying-markdown

This session only. Nothing lands on disk.

CHANGELOG.md

≈277 tokens on demand. Your agent reads this file only when SKILL.md points to it.

querying-markdown - Changelog

All notable changes to the querying-markdown skill are documented in this file. The format is based on Keep a Changelog.

[0.2.0] - 2026-06-04

Other

  • querying-markdown v0.2.0: use-gate + empirical findings (#687)

[0.2.0] - 2026-06-04

Added

  • Use-gate decision table ("Before you use mq: is this actually a structural task?") routing line-prefix/substring work to grep/awk and code-structure to tree-sitting, reserving mq for language-filtered code blocks, structured links, and valid-Markdown transforms.
  • "Empirical findings" section: parse-bound performance (latency tracks document size, not selector/match count; ~1.3 MB/s), selectors-return-nodes-not-concepts, and the ambiguous-empty-result trap.

Notes

  • Findings measured against a full KJV smoke test. The cheatsheet's .code("lang") | to_text() idiom is correct (an earlier "bug" report was a dash time: not found error misread as empty output).

[0.1.0] - 2026-06-04

Other

  • Add querying-markdown skill (mq, jq-for-Markdown) (#686)

Source: SKILL.md on GitHub

Third-party checks

2 alerts3mo3 checks · Risk HIGH
  • Gen Agent Trust Hub3mo

    This skill installs a third-party Markdown utility by downloading an executable binary from an untrusted GitHub repository and using sudo privileges to place it in a system directory. It also creates a potential surface for indirect prompt injection when processing external Markdown files.

  • Socket3mo

    No alerts

  • Snyk3mo

    Risk: CRITICAL · 3 issues

Provenance

Signed by skilld at 4b31e7d. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub yesterday.

Activeupdated 4 months ago

Capability

metadata
{
  "version": "0.2.0"
}

README badge

README badge for oaustegard/claude-skills/querying-markdown