bmad-shard-doc

To split a large markdown file into smaller sections, this Skill runs npx @kayvan/markdown-tree-parser explode, dividing the document by level 2 headings and generating an index.md for organized navigation.

Sharding long markdown architecture notes into a navigable folder of section files simplifies editing, versioning, and publication workflows by breaking down long-form content into manageable, organized parts.

After markdown sharding completes, the Skill offers post-processing options to delete, archive, or keep the original file, utilizing permission checks and clear user prompts to prevent accidental data loss.

Yes, you can use npx @kayvan/markdown-tree-parser explode to shard markdown files without permanent installation, as the Skill executes the command directly while verifying destination and index.md creation.

Markdown sharding relies on level 2 headings to delineate sections, so documents lacking these headings will not be split into organized section files or generate a navigable index.md.