bmad-shard-doc

Splitting a markdown document into smaller files uses level 2 headings by default to create section-based shards. An index.md file is automatically generated to organize and navigate the resulting shard set.

Markdown sharding decomposes a large document into reusable modular content sections. This process removes manual effort while preserving structure, enabling easier editing, review, and maintenance for documentation workflows.

Yes, you need npx installed to run the required @kayvan/markdown-tree-parser dependency. The Skill validates source, destination, and output files before executing the section splitting and index generation.

After sharding, the Skill guides you to delete, archive, or keep the original document. Clear warnings about duplication risks are provided to help you manage the source file safely.

By default, the Skill splits markdown files using level 2 headings as the section boundaries. The metadata specifies this default behavior for creating the modular file structure.

The best way to organize split markdown documentation is generating an index.md file alongside the section shards. This creates a browsable structure for modular content decomposition and easier navigation.