Skip to content
Kitbay
Skill

bmad-shard-pro

MITUpdated on Nov 11, 202655,252GitHub starsIncludes scripts

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