bmad-shard-pro
A BMad Method skill that makes long documents easy for agents to read in parts.
What the skill teaches
A BMad Method skill that makes long documents easy for agents to read in parts. It first outlines the document and decides between leaving it alone (under about 50,000 characters), adding a detailed contents list near the start, or splitting it word for word into named shards of about 3 to 14 KB with a map file. Cuts are never made inside tables, numbered lists or code blocks, shards get names from their content, and the map's summaries note conflicting values rather than choosing one. A bundled Python script does the cutting and checks nothing was lost, the original moves to a .source folder, decisions go in a log, and edited shards are updated through a separate procedure.
Capabilities
- Decide whether to split a long document
- Split a document into shards with a map
- Add a contents list for agents
- Check that a split lost nothing
About
- Publisher
- BMad Code
- Tool
- Documentation
Install
The project doesn't document install steps that we could confirm. See the project's own instructions
What's inside
- assets/sharded-note.md
- bmod.toml
- evals/cases.json
- evals/triggers.json
- references/update.md
- scripts/shard_tool.py
- scripts/tests/test_shard_tool.py
MCP servers and skills can run code on your computer and act on your data. Review the source before installing.
This skill includes scripts that your agent may run.
Details
| Fact | Value | Source |
|---|---|---|
| Type | Skill | |
| Tool | Documentation | |
| Publisher | BMad Code | source |
| Official status | Not stated in its documentation | |
| Needs an API key or sign-in | Not stated in its documentation | |
| Includes scripts | Yes | source |
| Platforms | Not stated in its documentation | |
| AI clients | Not stated in its documentation | |
| Licence | MIT | source |
| Pricing | Not stated in its documentation | |
| Activity | Last commit Nov 11, 202655,252 GitHub starsDownload data not available (not on npm or PyPI) | source |
| Links | Repository |
More from BMad Code
23 skills
- bmad-party-mode (Skill)
- bmad-review (Skill)
- bmad-advanced-elicitation (Skill)
- bmad-agent-analyst (Skill)
- bmad-agent-pm (Skill)
- bmad-agent-po (Skill)
Also listed under: Documentation
Sources
- Skill file (SKILL.md)github.com/bmad-code-org/BMAD-METHOD · Backs: Includes scriptsNov 17, 2026
- GitHub repositorygithub.com/bmad-code-org/BMAD-METHOD · Backs: Licence, PublisherNov 17, 2026
- GitHub repositorygithub.com/bmad-code-org/bmad-method · Backs: ActivityNov 11, 2026
- Skill file (SKILL.md)github.com/bmad-code-org/BMAD-METHOD · Backs: LicenceNov 10, 2026
- Folder in the repository (bmad-shard-pro)github.com/bmad-code-org/BMAD-METHOD · Backs: Includes scriptsNov 10, 2026