skill-chunk-md

Transform Markdown documents into CtxFST-formatted semantic chunks with frontmatter metadata.

Updated Feb 3, 2026
One-click install
npx skills add https://github.com/ctxfst/skill-chunk-md --skill skill-chunk-md
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-chunk-md
Source: https://github.com/ctxfst/skill-chunk-md/tree/main
Command: npx skills add https://github.com/ctxfst/skill-chunk-md --skill skill-chunk-md

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

Long-form Markdown docs often become hard to navigate and retrieve specific information from, especially when chunk boundaries are unclear and frontmatter metadata is missing.

Core Features & Use Cases

  • Semantic chunking of Markdown into self-contained chunks using <Chunk> tags to preserve meaning and enable precise retrieval.
  • YAML frontmatter integration to store chunk metadata (ids, tags, context, and optional RAG fields) for LanceDB/LightRAG/HippoRAG pipelines.
  • End-to-end workflow guidance for validating, exporting, and indexing chunks to support scalable RAG architectures.

Quick Start

Provide a Markdown document and the skill will return a CtxFST-formatted version with <Chunk> wrappers and frontmatter.

Frequently Asked Questions about skill-chunk-md

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

FAQPage Schema
How do I chunk Markdown documents for semantic retrieval in RAG pipelines?

Chunk Markdown documents for semantic retrieval by wrapping text in <Chunk> tags and injecting YAML frontmatter. This preserves meaning and enables precise indexing for pipelines like LanceDB, LightRAG, and HippoRAG.

What is semantic chunking and why does it matter for long-form Markdown?

Semantic chunking splits long-form Markdown into self-contained units using <Chunk> tags. It prevents meaning loss across boundaries and adds frontmatter metadata, ensuring reliable retrieval and reranking for RAG applications.

Does LanceDB work with Markdown chunks that include frontmatter metadata?

Yes, LanceDB works seamlessly with Markdown chunks that include YAML frontmatter. The consistent schema containing ids, tags, context, and optional RAG fields ensures reliable indexing and retrieval.

How do I add YAML frontmatter to Markdown chunks for consistent indexing?

Add YAML frontmatter to Markdown chunks by defining a schema with ids, tags, context, and optional RAG fields. This metadata standardizes chunk boundaries and supports scalable retrieval architectures.

What is the best way to structure Markdown chunk boundaries for retrieval?

The best way to structure Markdown chunk boundaries is using <Chunk> tags to create self-contained segments. Enforcing a consistent chunk structure with frontmatter metadata ensures reliable retrieval and reranking.

Can I use Markdown chunking with LightRAG and HippoRAG pipelines?

Yes, you can use Markdown chunking with LightRAG and HippoRAG pipelines. The skill formats chunks with consistent frontmatter schemas and <Chunk> tags to support scalable RAG architectures.