agentsclimarketplace

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

Install
npx -y skills add Goodnight77/rag-skills --skill hierarchical-chunking

Assembled 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

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

Keep looking

Skills are one crate of 627,801. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.