evo-shard-doc

Split large Markdown documents into level-2 heading-based shards with an index.

Updated Apr 6, 2026

Search Tags:#automation #markdown #split #document #headings #section #shard

Ready to run

npx skills add https://github.com/DavidsonGomes/claude_cowork_workspace --skill evo-shard-doc

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: evo-shard-doc
Source: https://github.com/DavidsonGomes/claude_cowork_workspace/tree/main/.claude/skills/evo-shard-doc
Command: npx skills add https://github.com/DavidsonGomes/claude_cowork_workspace --skill evo-shard-doc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Large Markdown documents are hard to navigate, edit, and reuse, causing slow collaboration and errors when making changes across sections.

Core Features & Use Cases

Splits a single document into smaller, level-2-based shards that can be edited independently.
Preserves order and hierarchy while exporting a clear set of files for reuse and reference.
Use Case: break a long product spec or knowledge base into modular pieces for versioning and quick sharing.

Quick Start

Run evo-shard-doc on a long Markdown file to automatically split it into level-2 section-based shards.

Frequently Asked Questions about evo-shard-doc

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I split a large Markdown document into smaller sections?▼

To split a large Markdown document into smaller sections, you need a tool that parses by level-2 headings and outputs individual files named by section titles. This process creates modular shards with an index for easier navigation.

What is the best way to break down a long knowledge base for modular editing?▼

The best way to break down a long knowledge base for modular editing is sharding the Markdown file by level-2 headings. This preserves document hierarchy and order while exporting independent files for quick reuse and versioning.

Can I split Markdown files by headings and preserve the original hierarchy?▼

Yes, you can split Markdown files by headings and preserve the original hierarchy. The sharding process parses level-2 sections to ensure content order is maintained, generating a set of named files alongside a structural index.

Does Markdown splitting work for long manuals and research notes?▼

Markdown splitting works effectively for long manuals and research notes. By breaking these extensive documents into level-2 heading-based shards, it enables independent editing and reusable sections without causing slow collaboration.

How do I automate Markdown document sharding for versioning and sharing?▼

To automate Markdown document sharding for versioning and sharing, run the splitting process directly on the long file. It automatically divides content by level-2 headings and generates an index file plus individual section files for quick reference.

What are the limitations of splitting Markdown by level-2 headings?▼

A limitation of splitting Markdown by level-2 headings is that sections without a level-2 heading may not be properly isolated into individual shards. This approach is best suited for well-structured documents like manuals and wikis requiring modular editing.