Chunking Strategy

Guía para la segmentación de documentos en pipelines RAG: tamaño, solapamiento y estrategia de límites

Por giuseppe-trisciuoglio · giuseppe-trisciuoglio/developer-kit

Probado · Funciona ★ 8.0/10

Chunking Strategy — Guía para la segmentación de documentos en pipelines RAG: tamaño, solapamiento y estrategia de límites

Qué hace

Una habilidad de conocimiento que recomienda estrategias de segmentación para la generación aumentada por recuperación: tamaño de chunk (256-1024 tokens), solapamiento (10-20%) y una escalera de 5 niveles desde segmentación de tamaño fijo hasta semántica y tardía, además de fragmentos de validación en línea para coherencia y precisión. Se activa al construir sistemas RAG, bases de datos vectoriales o dividir documentos grandes para incrustación.

Informe de la prueba

SKILL.md localizado en plugins/developer-kit-ai/skills/chunking-strategy; el frontmatter se analiza con name+description y allowed-tools limpios. Referencias verificadas: strategies.md, implementation.md, evaluation.md — todos HTTP 200 y sustantivos (strategies.md tiene 422 líneas con código langchain real y una tabla de parámetros). Instalación/documentación penalizadas con un punto cada una: el cuerpo dice que se ejecute `evaluate_chunks.py --coherence` pero no existe tal script en el árbol del repositorio (en realidad redirige a fragmentos de python -c en línea). Prueba de salida: segmenté un documento markdown de 4 secciones de dos maneras. La división ingenua de 220 caracteres de la línea base separó palabras y oraciones (el chunk 2 comenzó con "ooting" de la división "Troubleshooting"; el chunk 1 se abrió con un fragmento huérfano "reads it at startup..." sin encabezado). Siguiendo la guía de la habilidad de Nivel 3 consciente de la estructura para markdown, se produjeron 4 chunks de sección limpios (22-29 palabras cada uno), cada chunk con su propio encabezado y cero palabras/oraciones divididas, satisfaciendo directamente el requisito de la habilidad de que "chunks maintain standalone meaning". Mejora concreta y medible sobre la línea base.

Probado el: 2026-07-31 · Claude Code 2.x (agent harness)

Instalación

git clone --depth 1 https://github.com/giuseppe-trisciuoglio/developer-kit.git /tmp/chunking-strategy-src
mkdir -p ~/.claude/skills
cp -R /tmp/chunking-strategy-src/plugins/developer-kit-ai/skills/chunking-strategy ~/.claude/skills/chunking-strategy
# Pure-guidance skill: no runtime deps to install the skill itself.
# The optional inline validation snippets in SKILL.md need: pip install sentence-transformers numpy
# Note: SKILL.md says "run evaluate_chunks.py --coherence" but no such script is bundled;
#   the actual validation is the inline `python -c` snippets directly below that line.

Comandos y prompts de ejemplo

  • /chunking-strategyGuía para la segmentación de documentos en pipelines RAG: tamaño, solapamiento y estrategia de límites

Los skills se activan con peticiones en lenguaje natural, sin comandos que memorizar. Tras instalarlo, prompts como estos lo activan (en inglés):

  • Recommend a chunk size for this document set
  • Evaluate retrieval precision for my RAG pipeline
  • Choose an overlap percentage for semantic chunking