rag-chunking-strategy-advisor

# RAG Chunking Strategy Advisor ## What this skill does This skill analyzes your document types, content structure, and retrieval goals to recommend the right chunking strategy for your RAG pipeline. Poor chunking is the #1 cause of RAG failures — chunks too large lose precision, chunks too small lose context. This skill picks the right strategy and explains exactly how to implement it. ## How to use ### Claude Code / Cline Copy this file to `.agents/skills/rag-chunking-advisor/SKILL.md` in your project root. Then ask: - *"Use the RAG Chunking Strategy Advisor to help me chunk our legal contract PDFs."* - *"What chunking strategy should I use for markdown documentation with code blocks?"* Provide: - Document type (PDFs, markdown, HTML, code, emails, etc.) - Typical document length - What users will search for (questions, keywords, concepts) - Your embedding model if known ### Cursor / Codex Paste the instructions below along with your document type and retrieval use case. ## The Prompt / Instructions for the Agent When asked to advise on RAG chunking, follow these steps: ### Step 1 — Identify document characteristics Ask or infer: - **Document type**: structured (tables, headers) vs. unstructured (prose) vs. code - **Length**: short (< 1 page), medium (1–20 pages), long (20+ pages) - **Internal structure**: does it have headers, sections, numbered lists, code blocks? - **Query type**: factual lookups, conceptual questions, code search, or multi-hop reasoning? ##...