Hierarchical chunking
Skill Goodnight77/rag-skills/skills/chunking/hierarchical-chunking
Chunk nested documents into parent-child levels so retrieval can move from broad sections to fine-grained passages.From its SKILL.md
npx -y skills add Goodnight77/rag-skills --skill hierarchical-chunkingAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 7 stars7 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
SKILL.md
4.3 KB, as published. Nobody here has run it
Overview
Hierarchical chunking creates multi-level chunk structures that preserve document hierarchies (chapters, sections, subsections). This enables both broad-overview retrieval (high-level chunks) and detailed retrieval (low-level chunks) with parent-child relationships for context propagation.
Problem Statement
Flat chunking strategies lose the structural relationships within documents:
- Questions about broad topics retrieve detailed fragments instead of summaries
- No way to retrieve "context for context" - when a detail is retrieved, its containing section is lost
- Navigation through document hierarchies becomes impossible
- Retrieval results can't be organized by document structure
Key Concepts
- Parent-Child Relationships: Links between summary chunks and their detailed sub-chunks
- Multi-Level Granularity: Chunks at different abstraction levels (document → chapter → section → paragraph)
- Context Propagation: Ability to include parent context when retrieving child chunks
- Metadata Enrichment: Storing hierarchy information for filtering and navigation
- Recursive Chunking: Applying chunking rules recursively through document structure
Implementation Guide
Step 1: Parse Document Structure
Extract the hierarchical structure of your documents.
Why: Proper parsing is foundational - you can't create a hierarchy without understanding the structure.
Step 2: Create Multi-Level Chunks
Generate chunks at multiple levels from the parsed hierarchy.
Why: Multiple chunk levels allow different retrieval strategies - summary chunks for broad questions, detailed chunks for specifics.
Step 3: Store Hierarchy Metadata
Persist hierarchy information for retrieval-time context propagation.
Why: Metadata enables filtering and hierarchical queries (e.g., "retrieve from level 2 or deeper").
Step 4: Implement Hierarchical Retrieval
Retrieve chunks with optional parent context.
Why: Hierarchical retrieval allows users to "zoom in" from broad topics to specific details, just like browsing a table of contents.
For implementation details, see the LlamaIndex HierarchicalNodeParser, LangChain RecursiveCharacterTextSplitter, Haystack HierarchicalDocumentSplitter, and LlamaIndex Recursive Retriever + Node References.
When to Use This Skill
- Long-form documents with clear structure (books, technical documentation, research papers)
- When you need both summary and detailed retrieval
- For applications that support "drill-down" navigation
- When building document browsing/search interfaces
- For Q&A systems that benefit from hierarchical context
When NOT to Use This Skill
- Flat content without structure (blog posts, single-page articles)
- When storage complexity outweighs retrieval benefits
- For small document collections where simple chunking suffices
- When retrieval latency is critical (hierarchical retrieval adds overhead)
Related Skills
- Semantic Chunking - For content-aware chunking
- Sliding Window Chunking - For context overlap
- Multi-Pass Retrieval with Reranking - For refining hierarchical results
Metrics & Success Criteria
- Coverage: All document content preserved across hierarchy levels
- Retrieval Flexibility: Can retrieve at any abstraction level
- Context Relevance: Parent context improves answer quality for detailed questions
- Storage Efficiency: Metadata overhead doesn't exceed 30% of storage
- Query Latency: Hierarchical retrieval within 2x of flat retrieval