gaia-shard-doc

What problem does it solve?

Split a large Markdown document into smaller, navigable shards while preserving content and producing an index.md that links to each shard; the original document's structure and content are kept intact.

Core Features & Use Cases

• Default split level is H2, with the option to override to H1 or H3 using --level=H1|H2|H3.
• Preserves all content; content before the first split-level heading becomes _preamble.md, and a linking index is created.
• Generates an index.md that links to all shards with their headings for easy navigation.
• Asks for user confirmation before writing files; supports automatic proceeding in YOLO/non-interactive mode.
• Handles the zero-heading edge case by emitting a clear message and not creating shards or output directories.

Quick Start

Run the shard-doc skill on a source Markdown file to produce a shard directory containing all generated shards and an index.