01 Qué resuelve
Pegar un capítulo en el chat funciona una vez. Al cerrar la conversación hay que repetirlo, y meter un libro entero en el contexto es caro y lento. book-to-skill hace el trabajo de estructurar el contenido una sola vez: extrae el texto en tu ordenador con un script de Python y luego tu agente lo destila en una skill con varios archivos que se cargan por partes.
Según las mediciones del propio proyecto, responder una pregunta con la skill consume entre 24 y 51 veces menos tokens que volcar el libro completo en el contexto.
| Archivo generado | Contenido | Cuándo se carga |
|---|---|---|
| SKILL.md | Ideas centrales e índice de capítulos (unos 4.000 tokens). | Al invocar la skill o hablar del tema. |
| chapters/ | Un archivo sintetizado por capítulo (unos 1.000 tokens cada uno). | Solo cuando la pregunta toca ese capítulo. |
| glossary.md | Términos clave ordenados con referencia al capítulo. | Al preguntar por un concepto. |
| patterns.md | Técnicas, algoritmos y patrones descritos en el libro. | Al pedir que apliques algo del libro. |
| cheatsheet.md | Tablas de decisión y reglas rápidas. | En preguntas de «cuándo usar X o Y». |
02 Instalación
# Con el CLI de skills (sirve para cualquier agente compatible)
npx skills add virgiliojr94/book-to-skill
# O clonando el repositorio en tu carpeta de skills de Claude Code
git clone https://github.com/virgiliojr94/book-to-skill.git ~/.claude/skills/book-to-skillDespués, comprueba qué extractores tienes disponibles. El script te dice formato por formato qué falta y el comando exacto para instalarlo:
python3 ~/.claude/skills/book-to-skill/scripts/extract.py --check| Formato | Extractor recomendado | Instalación |
|---|---|---|
| PDF técnico (código, tablas) | Docling | pip3 install docling |
| PDF de texto corrido | pdftotext, pypdf o pdfminer.six | poppler-utils o pip3 install pypdf |
| EPUB | ebooklib + beautifulsoup4 | pip3 install ebooklib beautifulsoup4 |
| DOCX | python-docx | pip3 install python-docx |
| MOBI / AZW / AZW3 | Calibre (ebook-convert) | Aplicación externa, no pip |
| TXT, Markdown, RST, AsciiDoc | Biblioteca estándar | Nada |
03 Convertir tu primer documento
-
1
Elige bien el origen
Comprueba que puedes seleccionar y copiar texto del PDF. Si es un escaneo, primero pásalo por OCR (por ejemplo con ocrmypdf): la herramienta lo detecta en las primeras páginas y se detiene.
-
2
Lanza la conversión
En Claude Code ejecuta /book-to-skill seguido de la ruta y, opcionalmente, el nombre corto que quieres para la skill. Acepta un archivo, varios, una carpeta o un patrón entre comillas.
-
3
Responde al tipo de libro
Te preguntará si es técnico o de texto corrido para elegir extractor. Docling conserva tablas y bloques de código, pero tarda alrededor de 1,5 segundos por página.
-
4
Revisa el resultado
Abre el SKILL.md y un par de capítulos. Si algo se ha extraído mal (cabeceras repetidas, capítulos partidos), corrígelo antes de usarla a diario.
-
5
Úsala en una sesión nueva
Invoca la skill por su nombre, con un tema o con un número de capítulo.
# Un libro con nombre corto
/book-to-skill ~/Libros/manual-ventas.epub manual-ventas
# Toda la documentación interna en una sola skill
/book-to-skill ~/empresa/procedimientos/ procedimientos
# Añadir material nuevo a una skill existente
/book-to-skill ~/empresa/nuevo-protocolo.pdf ~/.claude/skills/procedimientos
# Consultar
/manual-ventas
/manual-ventas objeciones
/manual-ventas ch0504 Casos de uso en empresa
Procedimientos internos
Manuales de operaciones, protocolos de atención o guías de incorporación convertidos en una skill que el equipo consulta mientras trabaja.
Manual de marca
Tono de voz, mensajes y reglas visuales para que los textos y piezas que pidas a Claude respeten la marca sin pegar el PDF cada vez.
Documentación de producto
Base para preparar respuestas de soporte que citan el capítulo de donde sale cada dato.
Normativa y especificaciones
Contratos tipo, especificaciones de API o normas técnicas que consultas a menudo pero nunca memorizas.
Usa la skill /procedimientos como única fuente. Un cliente pregunta: [pega la consulta]. Redacta una respuesta breve y cercana, indica entre paréntesis el capítulo o sección de donde sale cada dato y, si el procedimiento no cubre el caso, dilo claramente en lugar de suponer.Estoy decidiendo [describe la decisión]. Carga /[nombre-de-la-skill] y dime qué recomienda el libro para un caso como este, en qué capítulo lo trata y en qué difiere de lo que tú propondrías por defecto. Si el libro no lo cubre, dilo.05 Límites, privacidad y derechos
- ✓No hace OCR: los PDF escaneados necesitan pasar antes por una herramienta de reconocimiento de texto.
- ✓La extracción es local, pero el texto que procesa el modelo sigue las condiciones de tu proveedor de IA, como cualquier otro prompt.
- ✓Las skills quedan como Markdown legible en tu disco; si contienen información confidencial, comprueba el cifrado del equipo y si esa carpeta se sincroniza con la nube.
- ✓En libros de más de 500 páginas el índice crece mucho; mejor dividirlos en dos o tres skills por partes.
- ✓Para un documento que vas a consultar una sola vez, pegarlo en una conversación sigue siendo más rápido.
Preguntas frecuentes
No. Sigue el estándar abierto de Agent Skills, así que también funciona en Codex, GitHub Copilot CLI, Amp, OpenCode, Hermes Agent y OpenClaw. Cambia solo la carpeta donde se instala.
Sí. Acepta cualquier texto estructurado: carpetas de documentación, especificaciones, artículos o tus propias notas. Puedes combinar varios archivos en una misma skill.
No. Los capítulos generados son síntesis: conceptos, definiciones y reglas, no reproducciones del texto original.
Ejecuta /book-to-skill con el archivo nuevo y, como segundo argumento, la ruta de la skill existente. El material se incorpora a la misma skill.
La conversión necesita un agente que ejecute el script de Python, como Claude Code. La skill resultante, como cualquier carpeta con SKILL.md, puede subirse comprimida en Customize > Skills si quieres usarla en Claude.
Sobre el autor
Equipo editorial de appyweb
Marketing, SEO y desarrollo con IA
Especialistas de appyweb en SEO, publicidad, desarrollo web y automatización con IA.