Claude MarketplacesSubmit
bmad-code-org avatar

Bmad Shard Doc

bmad-code-org/bmad-method

Takes a large markdown file and splits it into smaller files organized by level 2 headings using the markdown-tree-parser package. You point it at a doc, it creates a folder with separate files for each major section plus an index. The workflow is methodical: it verifies your paths, runs the split, checks the output, then asks what to do with the original (delete, archive, or keep). The skill actually warns you against keeping both versions since having duplicate content defeats the point and can confuse context discovery. Useful when you've got a massive architecture doc or spec that's become unwieldy to navigate and edit.

skills.sh installs
260
GitHub stars
55.2K
last updated
Aug 21, 2026
View on GitHub

Install

$ npx -y skills add bmad-code-org/bmad-method --skill bmad-shard-doc --agent claude-code

Installs into .claude/skills of the current project.

Files

Takes a large markdown file and splits it into smaller files organized by level 2 headings using the markdown-tree-parser package. You point it at a doc, it creates a folder with separate files for each major section plus an index. The workflow is methodical: it verifies your paths, runs the split, checks the output, then asks what to do with the original (delete, archive, or keep). The skill actually warns you against keeping both versions since having duplicate content defeats the point and can confuse context discovery. Useful when you've got a massive architecture doc or spec that's become unwieldy to navigate and edit.

Browse the repository on GitHub

Sponsors

Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthlyAgent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any language

Details

Repository
github.com/bmad-code-org/bmad-method
Category
Documentation
First seen
Jun 3, 2026

More from bmad-code-org/bmad-method

All 41

Recommended

More Documentation
1bmad-code-org avatarbmad-index-docsbmad-code-org/bmad-methodGenerates or updates an index.md to reference all docs in the folder. Use if user requests to create or update an index of all files in a specific folder259skills.sh installs
2existential-birds avataradr-writingexistential-birds/beagleUse when writing or formatting an ADR document using the MADR template, applying Definition of Done (E.C.A.D.R.) criteria, or verifying ADR completeness. Trigge250skills.sh installs
3nexu-io avatarblog-postnexu-io/open-designA long-form article / blog post — masthead, hero image placeholder, article body with figures and pull quotes, author byline, related posts. Use when the brief 245skills.sh installs
4shino369 avatardocument-writingshino369/claude-code-personal-workspaceExpert knowledge in document and essay writing conventions for English, Japanese, and Chinese (Traditional). Use when writing or translating formal documents, e241skills.sh installs
5nansen-ai avatarnansen-agent-guidenansen-ai/nansen-cliRouting guide -- when to use `nansen agent` (AI research) vs direct CLI data commands. Use when deciding how to answer a user's research question with Nansen to240skills.sh installs
6yunshu0909 avatarwriting-assistantyunshu0909/yunshu_skillshub写作助手 - 当用户说"我想写XX"、"帮我梳理选题"、"怎么形成框架"、"给我组织思路"时触发。根据观点清晰度自动选择最优路线：清晰观点走"框架→内容"，模糊观点走"挖掘→选题→框架→内容"。239skills.sh installs