bmad-shard-doc

Split markdown documents into sections at level 2 headings.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Manages the segmentation of large markdown files into manageable, structured documents based on level 2 headings.

Core Features & Use Cases

  • Document Sharding: Automatically divides markdown content into smaller sections based on specified criteria.
  • File Organization: Enhances document management by organizing large files into smaller, readable pieces.
  • Use Case: Ideal for users dealing with large documentation or technical writing, enabling easier navigation and organization of content.

Quick Start

To split a markdown document, provide the document path and specify the output directory.

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

To split a large markdown document, you use command-line parsing to automatically divide the file into smaller sections using level 2 headings as boundaries. This organizes extensive documentation into manageable pieces.

What is the best way to organize extensive markdown documentation?

The best way to organize extensive markdown documentation is document sharding, which automatically divides content into smaller, readable pieces based on specified heading boundaries. This enhances file management and accessibility.

How do I separate markdown content by level 2 headings?

You separate markdown content by level 2 headings by utilizing command-line parsing to read the file and slice it into structured documents. This segmentation uses the headings as strict boundaries for the output files.

Can I use command-line parsing to segment markdown files for better navigation?

Yes, you can use command-line parsing to segment markdown files for better navigation. The operation expects input files in markdown format and processes them to simplify navigation for users dealing with large documentation.

Does this markdown file splitting method work without external dependencies?

Yes, this markdown file splitting method works without external dependencies. It operates as a standalone script component, requiring only the markdown file path and an output directory to execute the segmentation.

When should I not use heading-based sharding for markdown files?

You should not use heading-based sharding for markdown files if your document lacks level 2 headings or relies on a different heading structure. The segmentation strictly expects level 2 headings to define the boundaries.