bmad-shard-doc

Split markdown documents into smaller files by section headers.

26|23|Updated Dec 16, 2025
One-click install
npx skills add https://github.com/laraxot/laravelpizza.com --skill bmad-shard-doc-laraxot
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-shard-doc
Source: https://github.com/laraxot/laravelpizza.com/tree/main/.github/skills/bmad-shard-doc
Command: npx skills add https://github.com/laraxot/laravelpizza.com --skill bmad-shard-doc-laraxot

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @kayvan/markdown-tree-parser, and includes scripts (resource) components.

What problem does it solve?

This Skill automates the process of splitting large markdown documents into smaller, organized files, making them easier to navigate and manage.

Core Features & Use Cases

  • Document Sharding: Automatically divide markdown documents into smaller files based on section headers.
  • Customizable Output: Allows users to specify the level of section headers to use for splitting documents.
  • Simple Execution: Offers a straightforward command for splitting documents with minimal input required.

Quick Start

To shard the 'project-document.md' file, use the command: 'bmad-shard-doc perform shard document [project-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 by headers?

You can split a markdown document by running the shard command, which automatically divides the file into smaller, organized files based on section headers. This makes large documentation sets much easier to navigate and manage.

What is the best way to organize large markdown documentation sets automatically?

Automating document sharding is the best way to organize large markdown files, as it parses section headers to divide content into manageable files. This requires minimal input and streamlines document management.

Do I need to specify header levels when splitting markdown files?

Yes, the document splitting process allows you to specify the level of section headers to use for dividing the markdown document. This customizable output ensures the sharding meets your specific organization needs.

Does splitting markdown documents require any specific parsing tools?

Yes, splitting markdown documents requires the `@kayvan/markdown-tree-parser` package to parse and split the document structure. The Skill automates this process using the parser to extract section headers.

Can I use this markdown file splitting approach for large project documentation?

Yes, this document sharding approach is ideal for organizing large project documentation sets. It divides large markdown files into smaller, manageable files, making them significantly easier to navigate.