evo-shard-doc

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

Updated Apr 6, 2026
One-click install
npx skills add https://github.com/DavidsonGomes/claude_cowork_workspace --skill evo-shard-doc
Or copy as Structured Prompt for Agent
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.