{"id":"65efa791-0a1f-4f5f-8fbf-ecd51af9b748","shortId":"TjB8Q2","kind":"skill","title":"Query and rewrite Markdown structure with mdq","tagline":"Use mdq when an agent needs to target headings, lists, links, or other Markdown structure without falling back to brittle regex edits.","description":"# Query and rewrite Markdown structure with mdq\n\nUse mdq when an agent needs to target headings, lists, links, or other Markdown structure without falling back to brittle regex edits.\n\n## Prerequisites\n\nmdq and Markdown files to inspect or rewrite.\n\n## Installation\n\nUse the upstream install or setup path that matches your environment:\n- brew install mdq\n- docker pull yshavit/mdq\n- cargo install --git https://github.com/yshavit/mdq\n- cargo build\n\nRequirements and caveats from upstream:\n- reviewers to complete. Enforcing these often requires ugly regexes that are a pain to write and worse to debug. Instead,\n- echo 'My [example](https://github.com/yshavit/mdq) markdown' | docker run --rm -i yshavit/mdq '[]()'\n- To use a specific release version, use yshavit/mdq:<version>. See [Docker Hub] for available version tags.\n\nBasic usage or getting-started notes:\n- For example, GitHub PRs are Markdown documents, and some organizations have specific templates with checklists for all\n- you can (for example) ask mdq for all uncompleted tasks:\n- [!tip]\n\n- Source: https://github.com/yshavit/mdq\n- Extracted from upstream docs: https://raw.githubusercontent.com/yshavit/mdq/HEAD/README.md\n\n## Documentation\n\n- https://github.com/yshavit/mdq\n\n## Source\n\n- [Agent Skill Exchange](https://agentskillexchange.com/skills/query-and-rewrite-markdown-structure-with-mdq/)","tags":["query","and","rewrite","markdown","structure","with","mdq","skills","agentskillexchange","agent-skills","ai-agents","ai-tools"],"capabilities":["skill","source-agentskillexchange","skill-query-and-rewrite-markdown-structure-with-mdq","topic-agent-skills","topic-ai-agents","topic-ai-tools","topic-awesome-list","topic-claude-code","topic-codex","topic-cursor","topic-llm","topic-mcp","topic-npx-skills","topic-openclaw","topic-skills-catalog"],"categories":["skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/agentskillexchange/skills/query-and-rewrite-markdown-structure-with-mdq","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add agentskillexchange/skills","source_repo":"https://github.com/agentskillexchange/skills","install_from":"skills.sh"}},"qualityScore":"0.454","qualityRationale":"deterministic score 0.45 from registry signals: · indexed on github topic:agent-skills · 8 github stars · SKILL.md body (1,362 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-18T19:12:00.625Z","embedding":null,"createdAt":"2026-05-18T13:18:44.419Z","updatedAt":"2026-05-18T19:12:00.625Z","lastSeenAt":"2026-05-18T19:12:00.625Z","tsv":"'/skills/query-and-rewrite-markdown-structure-with-mdq/)':202 '/yshavit/mdq':91,184,195 '/yshavit/mdq)':124 '/yshavit/mdq/head/readme.md':191 'agent':12,41,197 'agentskillexchange.com':201 'agentskillexchange.com/skills/query-and-rewrite-markdown-structure-with-mdq/)':200 'ask':174 'avail':143 'back':25,54 'basic':146 'brew':80 'brittl':27,56 'build':93 'cargo':86,92 'caveat':96 'checklist':167 'complet':101 'debug':117 'doc':188 'docker':83,126,140 'document':159,192 'echo':119 'edit':29,58 'enforc':102 'environ':79 'exampl':121,154,173 'exchang':199 'extract':185 'fall':24,53 'file':63 'get':150 'getting-start':149 'git':88 'github':155 'github.com':90,123,183,194 'github.com/yshavit/mdq':89,182,193 'github.com/yshavit/mdq)':122 'head':16,45 'hub':141 'inspect':65 'instal':68,72,81,87 'instead':118 'link':18,47 'list':17,46 'markdown':4,21,33,50,62,125,158 'match':77 'mdq':7,9,36,38,60,82,175 'need':13,42 'note':152 'often':104 'organ':162 'pain':111 'path':75 'prerequisit':59 'prs':156 'pull':84 'queri':1,30 'raw.githubusercontent.com':190 'raw.githubusercontent.com/yshavit/mdq/head/readme.md':189 'regex':28,57,107 'releas':135 'requir':94,105 'review':99 'rewrit':3,32,67 'rm':128 'run':127 'see':139 'setup':74 'skill':198 'skill-query-and-rewrite-markdown-structure-with-mdq' 'sourc':181,196 'source-agentskillexchange' 'specif':134,164 'start':151 'structur':5,22,34,51 'tag':145 'target':15,44 'task':179 'templat':165 'tip':180 'topic-agent-skills' 'topic-ai-agents' 'topic-ai-tools' 'topic-awesome-list' 'topic-claude-code' 'topic-codex' 'topic-cursor' 'topic-llm' 'topic-mcp' 'topic-npx-skills' 'topic-openclaw' 'topic-skills-catalog' 'ugli':106 'uncomplet':178 'upstream':71,98,187 'usag':147 'use':8,37,69,132,137 'version':136,144 'without':23,52 'wors':115 'write':113 'yshavit/mdq':85,130,138","prices":[{"id":"2f24093c-9ff7-41a9-987f-6c743640ef6b","listingId":"65efa791-0a1f-4f5f-8fbf-ecd51af9b748","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"agentskillexchange","category":"skills","install_from":"skills.sh"},"createdAt":"2026-05-18T13:18:44.419Z"}],"sources":[{"listingId":"65efa791-0a1f-4f5f-8fbf-ecd51af9b748","source":"github","sourceId":"agentskillexchange/skills/query-and-rewrite-markdown-structure-with-mdq","sourceUrl":"https://github.com/agentskillexchange/skills/tree/main/skills/query-and-rewrite-markdown-structure-with-mdq","isPrimary":false,"firstSeenAt":"2026-05-18T13:18:44.419Z","lastSeenAt":"2026-05-18T19:12:00.625Z"}],"details":{"listingId":"65efa791-0a1f-4f5f-8fbf-ecd51af9b748","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"agentskillexchange","slug":"query-and-rewrite-markdown-structure-with-mdq","github":{"repo":"agentskillexchange/skills","stars":8,"topics":["agent-skills","ai-agents","ai-tools","awesome-list","claude-code","codex","cursor","llm","mcp","npx-skills","openclaw","skills-catalog"],"license":"mit","html_url":"https://github.com/agentskillexchange/skills","pushed_at":"2026-05-18T19:02:17Z","description":"The open catalog of AI agent skills — 2,000+ security-scanned skills for Claude Code, Cursor, Codex, and more.","skill_md_sha":"50be21c60cfa504480a88b3d22d9251465be234e","skill_md_path":"skills/query-and-rewrite-markdown-structure-with-mdq/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/agentskillexchange/skills/tree/main/skills/query-and-rewrite-markdown-structure-with-mdq"},"layout":"multi","source":"github","category":"skills","frontmatter":{"name":"Query and rewrite Markdown structure with mdq","description":"Use mdq when an agent needs to target headings, lists, links, or other Markdown structure without falling back to brittle regex edits."},"skills_sh_url":"https://skills.sh/agentskillexchange/skills/query-and-rewrite-markdown-structure-with-mdq"},"updatedAt":"2026-05-18T19:12:00.625Z"}}