How does the Markdown Shard Document skill decide where to split?

By default, the skill identifies level 2 headers (##) within your Markdown document and uses them as the starting point for new files.

Is my original content safe during sharding?

The skill is designed to redistribute your content into new files exactly as written. However, as with all automated file operations, it is recommended to use version control like Git before running the command.

Can I customize the splitting behavior?

Yes, the skill follows the specific instructions and patterns defined in the _bmad/core/tasks/shard-doc.xml configuration file.

Does this skill work with Claude Code CLI?

Yes, this is a specialized Claude Code Skill designed to enhance Claude's ability to manipulate and organize your local workspace files.

What are the benefits of sharding Markdown files?

Sharding improves document maintainability, makes Git diffs easier to read, and allows for better navigation in large documentation projects.

Markdown Document Sharder

Name: Markdown Document Sharder
Author: thewoolleyman

bythewoolleyman

0•

内容管理

Splits large Markdown documents into smaller, organized files based on section headers to improve readability and management.

The bmad-shard-doc skill provides an automated way to refactor oversized Markdown files into a more manageable structure. By identifying level 2 headers (H2) as natural breaking points, it reorganizes monolithic documentation into a collection of smaller, focused files. This is particularly useful for technical writers and developers who need to maintain complex documentation, simplify version control diffs, or prepare content for static site generators. The skill follows a standardized workflow defined in the core task configuration to ensure consistency and prevent data loss during the sharding process.

主要功能

01Organized file creation for better documentation hierarchy

02Standardized output formatting for split files

030 GitHub stars

04Configurable sharding logic via XML task definitions

05Streamlined management of large-scale technical content

06Automatic document splitting based on H2 headers

使用场景

01Breaking down a massive single-file project README into a multi-page documentation site

02Refactoring long technical specifications into individual, chapter-based files

03Managing large knowledge bases by converting monolithic files into granular, modular components

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add thewoolleyman/tab-groups-windows-list bmad-shard-doc

For use in Claude.ai and ChatGPT

Download Skill