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.