Skills DirectorySkills Directory
SkillsLearnSecurityCategoriesDocsBlogPro
Sign InSubmit Skill
Skills Directory

Security-tested agent skills for Claude, coding agents, and AI workflows.

Directory

  • Browse Skills
  • All Skills A–Z
  • Claude Skills
  • Claude Code Skills
  • Agent Skills
  • Categories
  • Authors
  • Submit a Skill

Learn

  • Learn Hub
  • Install Claude Skills
  • Write SKILL.md
  • Skills vs MCP
  • Directories Compared

Security

  • Security
  • Methodology
  • Secure Claude Skills
  • Security Badges
  • Chrome Extension
  • Skill Manager

Company

  • About
  • Community
  • Blog
  • API Docs
  • Advertise

2026 Skills Directory. All rights reserved.

ProTermsPrivacyRefunds
Back to skills

Chunking Strategies

ASecurity

Split documents for retrieval effectively — fixed, semantic, structural, and hierarchical chunking with overlap tuning. Use when RAG retrieval quality depends on how documents are divided.

2 stars
0 votes
0 copies
0 views
Added 9/29/2026
ai-agentsgodebugging

Security Analysis

A100/100

Scanned 9/29/2026

$npx -y skills add aicodedecode/awesome-muse-skills --skill chunking-strategies --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Chunking Strategies?

Add the live security badge to your README — it updates automatically with every re-scan.

Security grade badge for Chunking Strategies
[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/aicodedecode-chunking-strategies/badge)](https://www.skillsdirectory.com/skills/aicodedecode-chunking-strategies)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

Download with Pro
Files
SKILL.md
---
name: chunking-strategies
description: Split documents for retrieval effectively — fixed, semantic, structural, and hierarchical chunking with overlap tuning. Use when RAG retrieval quality depends on how documents are divided.
category: ai-research
---

# Chunking Strategies

Chunking decides what the retriever can find: too large and the signal drowns; too small and 
context is lost; split in the wrong place and meaning breaks. It's the highest-leverage decision in 
most RAG pipelines — and the most under-tuned.

## Overview

Strategies range from naive (fixed token windows) to structure-aware (split on headings, 
paragraphs, tables) to semantic (split where meaning shifts) to hierarchical (small chunks with 
parent context). Overlap preserves boundary context. The right choice depends on content type — 
prose, tables, code, and transcripts chunk differently — and must be validated by inspecting 
actual chunks and measuring retrieval, not by theory.

## When to use

- Building or debugging any RAG pipeline.
- Retrieval returns "almost right" passages or fragments cut mid-thought.
- Mixed corpora: docs with tables, code blocks, headings, lists.
- Tuning retrieval quality when embeddings and ranking are already reasonable.

## Core concepts

- **Fixed-size chunking**: N tokens with M overlap — simple, predictable, content-blind. The 
baseline everything else must beat.
- **Structural chunking**: split on document structure — headings, sections, paragraphs, table 
boundaries. Preserves the author's organization; the best default for structured docs.
- **Semantic chunking**: split where embedding similarity between adjacent sentences drops — 
boundaries at meaning shifts. Better for unstructured prose; costs embedding calls.
- **Hierarchical chunking**: small retrievable chunks linked to parent sections — retrieve 
precise, generate with context. Best of both worlds at higher complexity.
- **Overlap**: shared tokens between adjacent chunks so boundary content isn't orphaned. Typically 
10–20%; more for dense technical text.
- **Metadata per chunk**: source, section heading, page, position — preserved through chunking 
for filtering, citations, and parent lookup.

## Practical workflow

1. Inspect your documents: structure, tables, code, average section length. Let the content suggest 
the strategy.
2. Start with structural chunking (sections/paragraphs) + modest overlap as the baseline.
3. Eyeball 30+ actual chunks: are tables intact? sentences complete? headings attached? Fix what's 
visibly broken.
4. Measure retrieval hit-rate on your eval set per strategy; try 2–3 strategies, not ten.
5. Tune size and overlap around the winner — smaller for precise QA, larger for synthesis tasks.
6. Consider hierarchical (child chunks + parent context) if small chunks retrieve well but answers 
lack context.

```text
Chunk inspection checklist (do this manually!):
[ ] No chunk starts/ends mid-sentence (except long lists)
[ ] Tables and code blocks intact within one chunk
[ ] Each chunk carries its section heading (metadata or prepended)
[ ] Chunk is self-contained enough to judge relevance alone
[ ] Overlap preserves boundary sentences
```

## Common pitfalls

- **Theory-driven chunking**: picking a strategy from a blog post without inspecting your chunks. 
Look at them.
- **Tables split across chunks**: the most common silent killer. Detect tables/lists and keep them 
whole.
- **No heading context**: a chunk saying "it increased 40%" with no idea what "it" is. Prepend 
section paths.
- **One size for all content**: 512 tokens for prose, tables, and code alike. Adapt to content type.
- **Zero overlap**: boundary sentences orphaned. Some overlap is nearly always worth it.
- **Tuning embeddings before chunking**: swapping embedding models while chunks are broken. Fix 
chunking first — it's usually the bottleneck.

Attribution

aicodedecodeaicodedecode
View sourceSee grades on GitHubMore from aicodedecode →
SSkills DirectorySkills Directory

Ship a skill? Prove it's safe.

Free 120-pattern security scan, letter grade, and an embeddable README badge.

Submit a skill

Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.

Comments (0)

No comments yet. Be the first to comment!

SSkills DirectorySkills Directory

Ship a skill? Prove it's safe.

Free 120-pattern security scan, letter grade, and an embeddable README badge.

Submit a skill

Related Skills

Caveman

Terse caveman voice: answer first, fluff gone, every technical fact kept. Use for /caveman, "caveman mode", "talk like caveman", "be brief", "less tokens". Stays on until "stop caveman" or "normal mode".

1100021 votes

Hyperplan

Adversarial multi-agent planning skill. Self-orchestrates 5 hostile category members (unspecified-low, unspecified-high, deep, ultrabrain, artistry) via team-mode for ruthless cross-critique debate, distills only the defensible insights, then MANDATORILY hands the distilled insight bundle to the `plan` agent for executable plan formalization. Use when planning needs maximum rigor and surfacing of weak assumptions, blind spots, and over-engineering. Triggers: 'hyperplan', 'hpp', '/hyperplan', ...

698621 votes

Writing Skills

Create and manage Claude Code skills in HASH repository following Anthropic best practices. Use when creating new skills, modifying skill-rules.json, understanding trigger patterns, working with hooks, debugging skill activation, or implementing progressive disclosure. Covers skill structure, YAML frontmatter, trigger types (keywords, intent patterns), UserPromptSubmit hook, and the 500-line rule. Includes validation and debugging with SKILL_DEBUG. Examples include rust-error-stack, cargo-dep...

3931 votes

Mcp Code Execution

Routes multi-tool workflows through MCP servers for large datasets and pipelines. Use when Bash tool overhead is limiting throughput on data-heavy tasks.

3421 votes

catchup

Recovers the conversation and failed tool calls of a previous Codex, Amp, Claude Code, Antigravity, Cline, Copilot CLI, Cursor, DeepSeek Harness, Grok Build, Kimi, OpenCode, Pi Agent, or ZCode session. Use when the user says "catch up", "what did the last session do", "get me up to speed", "I switched agents", asks to recover/summarize a previous session before continuing, or asks to diagnose or report a catchup failure. Do NOT use for the current conversation, git history, or any non-agent log.

741 votes
View all in ai-agents →