bmad-shard-doc

Split markdown documents into sections by specified header level.

Updated Apr 25, 2026
One-click install
npx skills add https://github.com/wahabmalik/whatsapp-chatbot --skill bmad-shard-doc-wahabmalik
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-shard-doc
Source: https://github.com/wahabmalik/whatsapp-chatbot/tree/main/.github/skills/bmad-shard-doc
Command: npx skills add https://github.com/wahabmalik/whatsapp-chatbot --skill bmad-shard-doc-wahabmalik

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Users dealing with large markdown documents often find the navigation and management of content challenging. This skill addresses this issue by splitting documents into manageable sections based on level 2 headers.

Core Features & Use Cases

  • Automated Document Splitting: Simplify document organization by dividing markdown files into smaller sections.
  • Default Section Level: Default to splitting documents into sections based on level 2 headers (default), or customizable.
  • User Flexibility: Offers a simple and flexible command to trigger the sharding process.
  • Use Case: Perfect for technical writers and content creators looking to improve document management.

Quick Start

To split your document 'readme.md', execute the command 'perform shard document'.

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?

Splitting large markdown documents into smaller sections requires parsing markdown headers and dividing the file by specified header levels. This process breaks down massive text files into manageable pieces, defaulting to level 2 headers for organization.

What is the best way to manage and navigate long markdown files?

Managing and navigating long markdown files is best achieved by splitting them into smaller, organized sections based on header levels. This document organization technique separates content by level 2 headers, making large files easier to navigate and manage.

Can I customize the header level used for markdown text splitting?

Customizing the header level for markdown text splitting is supported. While the default section level divides documents at level 2 headers, users can specify a user-defined section level to control exactly how the document is divided.

Does document sharding support markdown files with no level 2 headers?

Document sharding defaults to splitting markdown files at level 2 headers. If your markdown file lacks level 2 headers, you must specify a user-defined section level that matches the headers present in your document to ensure successful text splitting.

How do I trigger the document sharding process for my markdown file?

Triggering the document sharding process for a markdown file requires executing the 'perform shard document' command. This action automatically splits the markdown content into smaller, organized sections based on your specified section level.