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/05_PROCEDURE.md
View on GitHub---
description: Canonical execution path for this skill.
index:
- Step 1: Verify Source
- Step 2: Run Split Script
- Step 3: Generate Index
- Step 4: Verify Output
- Output Structure
---
# Procedure
Execution path for the md-split skill.
## Step 1: Verify Source
Confirm the source file exists and is markdown:
```bash
ls -la <source.md>
```
## Step 2: Run Split Script
```bash
./scripts/split.sh --in <source.md> [--out <output_dir>] [--prefix <NN>] [--dry-run] [--force] [--no-intro] [--manifest|--no-manifest]
```
Or on Windows:
```powershell
./scripts/split.ps1 --in <source.md> [--out <output_dir>] [--prefix <NN>] [--dry-run] [--force] [--no-intro] [--manifest|--no-manifest]
```
## Step 3: Generate Index
```bash
./scripts/index.sh --dir <output_dir>
```
## Step 4: Verify Output
Check that chunks were created:
```bash
ls -la <output_dir>/*.md
```
## Output Structure
```text
output_dir/
├── 00_INTRO.md # Optional: content before first H2 (only when meaningful)
├── 01_SECTION_ONE.md # First H2 section (promoted to H1)
├── 02_SECTION_TWO.md # Second H2 section (promoted to H1)
├── .INDEX.md # Generated index
└── .SPLIT.json # Optional: manifest (default on; disable with --no-manifest)
```
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 |