bmad-shard-doc

Split large markdown documents into level 2 section files with an index.

Updated Mar 16, 2026
One-click install
npx skills add https://github.com/geekdesign27/travailleursisoles --skill bmad-shard-doc-geekdesign27
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-shard-doc
Source: https://github.com/geekdesign27/travailleursisoles/tree/main/_bmad/core/skills/bmad-shard-doc
Command: npx skills add https://github.com/geekdesign27/travailleursisoles --skill bmad-shard-doc-geekdesign27

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill addresses the challenge of managing and working with excessively large markdown documents by breaking them down into more manageable, section-based files.

Core Features & Use Cases

  • Automated Document Splitting: Divides large markdown files into smaller files based on level 2 headings.
  • Organized Output: Creates a new directory structure with sharded files and an index file for easy navigation.
  • Use Case: If you have a lengthy technical specification document that is difficult to navigate or edit, this Skill can shard it into individual sections, making it easier to review, update, or share specific parts.

Quick Start

Use the bmad-shard-doc skill to split the document located at /path/to/large_document.md.

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 files?

You can split large markdown documents by automating document segmentation based on level 2 sections. This process creates a new directory structure containing sharded files and an index file for improved manageability and easy navigation.

What is the best way to automate markdown document segmentation for technical specifications?

The best way to manage excessively large markdown documents is to break them down into section-based files. This Skill addresses that challenge by creating organized output with sharded files and an index file for easy navigation.

How does document splitting handle the output file structure?

The markdown-tree-parser tool parses and explodes markdown content into a hierarchical file structure. This tool is required to automate the document segmentation process and generate the organized output directory.

How do I organize sharded markdown files for easier navigation?

To organize sharded markdown files, the Skill creates a new directory structure that includes an index file. This index file provides easy navigation throughout the segmented document sections.

Can I split a markdown document based on specific heading levels?

Yes, you can split a markdown document based on level 2 sections. The Skill parses the content and divides the file into smaller, organized files according to these level 2 headings.

Do I need any specific tools to parse and explode markdown content?

Yes, you need the markdown-tree-parser tool to parse and explode markdown content into a hierarchical file structure. This tool is required to automate the document segmentation process and generate the organized output directory.