chunking-strategy
Provides chunking strategies for RAG systems. Generates chunk size recommendations (256-1024 tokens), overlap percentages (10-20%), and semantic boundary detection methods. Validates semantic coherence and evaluates retrieval precision/recall metrics. Use when building retrieval-augmented generation
By giuseppe-trisciuoglio · 3,001 installs
npx skills add giuseppe-trisciuoglio/developer-kit --skill chunking-strategy
Source repository · Upstream listing
Chunking Strategy for RAG Systems
Overview
Provides chunking strategies for RAG systems, vector databases, and document processing. Recommends chunk sizes, overlap percentages, and boundary detection methods; validates semantic coherence; evaluates retrieval metrics.
When to Use
Use when building or optimizing RAG systems, vector search pipelines, document chunking workflows, or performance tuning existing systems with poor retrieval quality.
Instructions
Choose Chunking Strategy
Select based on document type and use case:
1. Fixed Size Chunking (Level 1)
Use for simple documents without clear structure
Start with 512 tokens and 10 20% overlap
Adjust: 256 for factoid queries, 1024 for analytical
2. Recursive Character Chunking (Level 2)
Use for documents with structural boundaries
Hierarchical separators: paragraphs → sentences → words
Customize for document types (HTML, Markdown, JSON)
3. Structure Aware Chunking (Level 3)
Use for structured content (Markdown, code, tables, PDFs)
Preserve semantic units: functions, sections, table blocks
Validate structure preservation post split
4. Semantic Chunking (Level 4)
Use for complex documents with thematic shifts
Embedding based boundary detection with 0.8 similarity threshold
Buffer size: 3 5 sentences
5. Advanced Methods (Level 5)
Late Chunking for long context models
Contextual Retrieval for high precision requirements
Monitor computational cost vs. retrieval gain
Reference: [references/strategies.md](references/strategies.md).
Implement Chunking Pipeline
1. Pre process documents
Analyze structure, content types, information density
Identify multi modal content (tables, images, code)
2. Select parameters
Chunk size: embedding model context window / 4
Overlap: 10 20% for most cases
Strategy specific settings
3. Process and validate
Apply chunking strategy
Validate coherence: run evaluate chunks.py coherence (see below)
Test with representative documents
4. Evaluate and iterate
Measure precision and recall
If precision < 0.7: reduce chunk size by 25% and re evaluate
If recall < 0.6: increase overlap by 10% and re evaluate
Monitor latency and memory usage
Reference: [references/implementation.md](references/implementation.md).
Validate Chunk Quality
Run validation commands to assess chunk quality:
Reference: [references/evaluation.md](references/evaluation.md).
Examples
Fixed Size Chunking
Structure Aware Code Chunking
Semantic Chunking
Best Practices
Core Principles
Balance context preservation with retrieval precision
Maintain semantic coherence within chunks
Optimize for embedding model context window constraints
Implementation
Start with fixed size (512 tokens, 15% overlap)
Iterate based on document characteristics
Test with domain specific documents before deployment
Pitfalls to Avoid
Over chunking: context poor small chunks
Under chunking: missing information in oversized chunks
Ignoring semantic boundaries and document structure
One size fits all for diverse content types
Constraints and Warnings
Resource Considerations
Semantic methods require significant compute resources
Late chunking needs long context embedding models
Complex strategies increase processing latency
Monitor memory for large document batches
Quality Requirements
Validate semantic coherence post processing
Test with representative documents before deployment
Ensure chunks maintain standalone meaning
Implement error handling for malformed content
References
[strategies.md](references/strategies.md) Detailed strategies
[implementation.md](references/implementation.md) Implementation guidelines
[evaluation.md](references/evaluation.md) Performance metrics
[tools.md](references/tools.md) Libraries and frameworks
[research.md](references/research.md) Research papers
[advanced strategies.md](references/advanced strategies.md) 11 advanced methods
[semantic methods.md](references/semantic methods.md) Semantic approaches
[visualization tools.md](references/visualization tools.md) Visualization tools