JordanGunn/nunchuck / skills/md/md-split
md-split
VerifiedSplits a Markdown file by H2 headings into numbered documents and generates an index file.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 529 B |
| assets/EXAMPLE.md | markdown | 445 B |
| references/00_ROUTER.md | markdown | 468 B |
| references/01_SUMMARY.md | markdown | 1023 B |
| references/02_TRIGGERS.md | markdown | 831 B |
| references/03_ALWAYS.md | markdown | 696 B |
| references/04_NEVER.md | markdown | 569 B |
| references/05_PROCEDURE.md | markdown | 1.3 KB |
| references/06_FAILURES.md | markdown | 973 B |
| scripts/index.ps1 | script | 818 B |
| scripts/index.shexecutable | script | 1.2 KB |
| scripts/skill.ps1 | script | 1.9 KB |
| scripts/skill.sh | script | 2.1 KB |
| scripts/split.ps1 | script | 5.7 KB |
| scripts/split.shexecutable | script | 8.3 KB |
references/01_SUMMARY.md
View on GitHub---
description: What this skill is and is not.
index:
- What It Does
- What Problems It Solves
- What It Is Not
- Key Invariant
- Scripts
---
# Summary
The **md-split** skill splits markdown files by H2 headings into numbered documents.
## What It Does
- Splits a single markdown file into multiple files by H2 sections
- Numbers output files sequentially (01, 02, 03...)
- Generates an index file listing all chunks
- Preserves heading hierarchy within chunks
## What Problems It Solves
- Large markdown files that exceed context limits
- Documents needing section-level addressing
- Content that benefits from chunked processing
## What It Is Not
- Not for restructuring document hierarchy
- Not for merging files (one-way split only)
- Not for non-markdown formats
## Key Invariant
**Deterministic splitting.** Same input always produces same output. Split points are H2 headings only.
## Scripts
- `split.sh` / `split.ps1` — Perform the split
- `index.sh` / `index.ps1` — Generate index file
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |