mh-shard-doc

Split large markdown documents into sections by level 2 headings.

2|Updated Apr 5, 2026
One-click install
npx skills add https://github.com/Imad-Oute/MicroHard --skill mh-shard-doc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mh-shard-doc
Source: https://github.com/Imad-Oute/MicroHard/tree/main/src/core/mh-shard-doc
Command: npx skills add https://github.com/Imad-Oute/MicroHard --skill mh-shard-doc

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @kayvan/markdown-tree-parser, and includes scripts (resource) components.

What problem does it solve?

This Skill addresses the challenge of managing large markdown documents by splitting them into smaller, organized files, making them more manageable and navigable.

Core Features & Use Cases

  • Document Sharding: Splits markdown documents into smaller sections based on level 2 headings.
  • User Interaction: Allows users to specify the source document and destination folder.
  • Post-Sharding Actions: Offers options to delete, move, or keep the original document after sharding.

Quick Start

Execute the command: perform shard document with the path to your markdown document.

Frequently Asked Questions about mh-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?

You can shard large markdown documents into smaller sections based on level 2 headings. This process organizes large markdown files into manageable, navigable individual files within a specified destination folder.

What is the best way to organize and manage large markdown files?

Document sharding is an effective way to manage large markdown files, breaking them down into smaller organized files by parsing level 2 headings. This makes large documents significantly more manageable and navigable.

How does sharding a markdown document by level 2 headings work?

Sharding by level 2 headings works by utilizing a markdown-tree-parser to parse the document structure. It then explodes the large markdown document into smaller sections, creating a separate file for each heading block.

Can I delete or move the original markdown file after sharding it into sections?

Yes, you can delete, move, or keep the original markdown document after sharding. The Skill offers these post-sharding actions to help you manage the source file once it is split into the destination folder.

Do I need a markdown parser to shard documents into separate files?

Yes, document sharding requires the @kayvan/markdown-tree-parser dependency to parse and explode large markdown documents. This parser provides the structural analysis needed to split files by level 2 headings.