md2idx-read

A skill for reading large Markdown files efficiently using md2idx. Instead of loading an entire file into context, first fetch the index (heading table of contents), then selectively retrieve only the sections needed for the current task.

The bundled scripts/md2idx-run.sh wrapper handles file size checking, md2idx command resolution (local build, PATH, npx), and execution. All Bash operations go through this single script, so one permissions.allow prefix covers the full workflow.

When to use

• Reading a large Markdown file (guideline: more than 200 lines or 10 KB)
• Only specific sections are needed, not the entire file
• The user explicitly asks to "read via md2idx", "check the index", or "read selectively"

When NOT to use

• Small Markdown files (under 200 lines) — reading directly with the Read tool is faster
• The entire file needs to be edited — the Edit tool requires full content
• Non-Markdown files

Workflow