The bmad-shard-doc skill is designed to manage high-volume documentation by breaking down monolithic markdown files into smaller, modular sections. By leveraging the markdown-tree-parser utility, it automatically segments files based on level 2 headings, creating a structured directory with an included index. This process is essential for AI-driven workflows where feeding an entire massive document into a context window is inefficient. The skill provides a guided execution path that includes source verification, destination setup, and safety-first handling of the original document through archiving or deletion options.
主要功能
01Automated splitting based on Level 2 markdown sections
02Standardized npx @kayvan/markdown-tree-parser execution
03Integrated file verification and output reporting
04Automatic generation of index.md for navigation
05Safe document lifecycle management (Delete/Archive/Keep)
0657 GitHub stars
使用场景
01Optimizing documentation for AI agents to prevent context window saturation
02Refactoring massive technical specifications into manageable modules
03Converting single-page READMEs into structured multi-page documentation folders