bmad-shard-doc

Shard large Markdown documents into level-2 section files with index.md.

Updated May 5, 2026
One-click install
npx skills add https://github.com/b566776/whitebox --skill bmad-shard-doc-b566776
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-shard-doc
Source: https://github.com/b566776/whitebox/tree/main/.gemini/skills/bmad-shard-doc
Command: npx skills add https://github.com/b566776/whitebox --skill bmad-shard-doc-b566776

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Large Markdown documents are hard to navigate and maintain, so this skill shards them into smaller, organized files for easier management and reuse.

Core Features & Use Cases

  • Shard by level-2 sections to create a navigable file tree.
  • Generate an index.md in the destination folder to preserve structure.
  • Useful for long-form docs, API specs, and knowledge bases that require modular sections.

Quick Start

Provide the source Markdown file path and run the shard operation to generate structured, sectioned outputs.

Frequently Asked Questions about bmad-shard-doc

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I split a large Markdown document into smaller organized files?

Sharding large Markdown documents breaks them into smaller, organized files based on level-2 sections. This process generates a navigable file tree and an index.md in a destination folder named after the source file for easier management.

What is the best way to organize long-form documentation into modular sections?

The best way to organize long-form documentation into modular sections is by sharding the source Markdown file by its level-2 headers. This creates a structured directory of sectioned outputs with an index.md to preserve the navigational structure.

Can I use npx to automatically shard Markdown files for a knowledge base?

Yes, you can use npx @kayvan/markdown-tree-parser to automatically shard Markdown files for knowledge bases. It explodes the source document into a destination folder, creating modular sectioned outputs and an index.md file.

Do I need any dependencies installed to shard Markdown documents?

You do not need any pre-installed dependencies to shard Markdown documents. The skill uses npx @kayvan/markdown-tree-parser to process the source file and generate the organized output structure on demand.

Does this Markdown sharding approach work for API specs and team documentation?

Yes, this Markdown sharding approach works for API specs and team documentation. It applies to long-form documentation and knowledge bases that require modular, sectioned outputs across projects and teams.