Splits large markdown documents into section files using markdown-tree-parser.
npx skills add https://github.com/LinCie/bearuang --skill bmad-shard-doc-lincie
Please help me install this Agent Skill. Skill: bmad-shard-doc Source: https://github.com/LinCie/bearuang/tree/main/.opencode/skills/bmad-shard-doc Command: npx skills add https://github.com/LinCie/bearuang --skill bmad-shard-doc-lincie
npx @kayvan/markdown-tree-parser explode to split a markdown file by level 2 sections into a destination folder. - Guided Workflow: Walks through source selection, destination confirmation, execution, output verification, and completion reporting with halt conditions on errors. - Original Document Handling: Offers delete, archive, or keep options for the source file after sharding to avoid duplicate content. - Use Case: You have a 2,000-line architecture.md file. Shard it into per-section files with an index.md so each section can be loaded on demand. ## Quick Start Shard the document docs/architecture.md into smaller section files using the default destination folder.High-intent search queries and answers about installing and using this skill.
Run the sharding workflow with your source markdown path, and it executes npx @kayvan/markdown-tree-parser explode to split the file by level 2 sections. Output files and an index.md are written to a destination folder named after the source file.
The @kayvan/markdown-tree-parser npm package splits markdown documents via its explode command. It parses the heading tree and writes each level 2 section as a separate file plus an index.md in the destination folder.
Yes, the workflow suggests a default folder named after the source file in the same location, but you can enter a custom path instead. It verifies the folder exists or can be created and checks write permissions before running.
You choose to delete it, move it to an archive subfolder, or keep it. Deleting or archiving is recommended because keeping both versions can cause duplicate content and confusion about which version to load.
Sharding halts if the source file is missing, is not a .md file, the destination lacks write permissions, or the npx command fails. The workflow verifies output files and index.md exist before reporting completion.
AMindToThinkConsolidate research notes, logs, and outputs into a structured markdown manuscript.
alessioroberto82Split large documents into atomic shards for efficient context management.
DavidsonGomesSplit large Markdown documents into level-2 heading-based shards with an index.
gkswls5006-webGenerate documentation patterns for Sphinx, MkDocs, TypeDoc, and Nextra.