본문으로 건너뛰기
cccskills
무료GitHub에 공개

chunking-strategies

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.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

설치 방법 보기

포함된 파일(1)

  • SKILL.md3.8 KB

SKILL.md(원문)

설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.

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.
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.

리뷰

아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.

댓글

로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.

아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.

보내면 바로 공개됩니다. 이메일 주소나 전화번호 같은 개인 정보는 쓰지 마세요. URL은 2개까지입니다.

0 / 1,000자

이 양식은 reCAPTCHA로 보호되며 Google 개인정보처리방침 및 서비스 약관이 적용됩니다.

같은 저장소의 스킬

Master 1Password: vaults, Watchtower, passkeys, SSH agent, CLI, and family/team administration. Use when getting full value from 1Password personally or administering it for others.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

aicodedecode/awesome-muse-skills282026년 10월 10일 업데이트

Create 3D visuals with modeling, texturing, lighting, rendering, and optimization for web and product.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

aicodedecode/awesome-muse-skills282026년 10월 10일 업데이트

Create 3D web experiences: scene setup, models, materials, lighting, animation, scroll-driven scenes, and performance budgets. Use when adding 3D to websites beyond basic demos.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

aicodedecode/awesome-muse-skills282026년 10월 10일 업데이트

Writing abstracts that get papers read — structured content, the 5-sentence core, and journal-specific constraints.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

aicodedecode/awesome-muse-skills282026년 10월 10일 업데이트

Learn effectively from courses and academies: choosing programs, studying actively, and converting courses into skills. Use when investing time/money in structured learning.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

aicodedecode/awesome-muse-skills282026년 10월 10일 업데이트

Audit designs for accessibility with WCAG checklists covering color, type, focus, motion, and content.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

aicodedecode/awesome-muse-skills282026년 10월 10일 업데이트

aicodedecode의 스킬 모두 보기

이 스킬의 문제 신고