bmad-shard-doc

Split large markdown documents into smaller files by level 2 sections.

Updated Mar 10, 2026
One-click install
npx skills add https://github.com/Dydyy-y/react-native --skill bmad-shard-doc-dydyy-y
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bmad-shard-doc
Source: https://github.com/Dydyy-y/react-native/tree/main/projet/.github/skills/bmad-shard-doc
Command: npx skills add https://github.com/Dydyy-y/react-native --skill bmad-shard-doc-dydyy-y

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill addresses the issue of large markdown documents being difficult to manage and navigate, offering a solution to divide them into smaller, more manageable sections.

Core Features & Use Cases

  • Document Sharding: Automatically splits markdown documents into smaller files based on level 2 sections.
  • User Input: Allows users to specify the source document and the destination folder for the sharded files.
  • Customization: Offers options for handling the original document after sharding, such as deleting, moving to an archive, or keeping it in place.

Quick Start

To shard a document, use the bmad-shard-doc skill and provide the path to the document you want to shard.

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

Splitting a large markdown document into smaller files is done by specifying the source path and destination folder; the tool automatically shards the file based on level 2 sections.

What is the best way to organize large markdown documentation?▼

Organizing large markdown documentation is best achieved through document sharding, which divides unwieldy files into manageable sections for much better navigation.

Can I specify how the original markdown file is handled after splitting?▼

Specifying how the original markdown file is handled after splitting is fully supported; you can choose to delete it, move it to an archive, or keep it in place.

How does markdown parsing work for level 2 sections during document splitting?▼

Markdown parsing for level 2 sections during document splitting works by identifying header boundaries and automatically separating the content into distinct files.

Why does managing a large markdown file become difficult without document organization?▼

Managing a large markdown file becomes difficult without document organization because unwieldy files are hard to navigate, making sharding into smaller files necessary for better access.

Do I need any dependencies to automate markdown document splitting?▼

You do not need any dependencies to automate markdown document splitting, as the tool operates independently without external requirements.