Cada vez que empieza una conversación nueva en Claude, el conocimiento de los libros que leíste desaparece. Book-to-Skill es una herramienta Python de código abierto que convierte libros (PDF, EPUB, DOCX, MOBI) en skills permanentes que Claude carga automáticamente cuando el tema es relevante. Especialmente útil para founders o equipos que trabajan con manuales técnicos, SOPs o libros de referencia que consultan semana tras semana.
El problema clásico de trabajar con libros técnicos en Claude es que el conocimiento no persiste. Puedes pegar capítulos enteros en el chat, pero al iniciar la próxima sesión, todo vuelve a cero. Las alternativas habituales —pegar fragmentos manualmente, mantener resúmenes en texto, usar RAG— tienen fricción o requieren infraestructura.
Book-to-Skill resuelve esto de forma elegante: toma un libro completo y lo descompone en cinco archivos markdown organizados dentro de ~/.claude/skills/<nombre>/. Desde ese momento, Claude puede cargar ese conocimiento bajo demanda cuando sea relevante, sin consumir el presupuesto de tokens de forma permanente.
Es una herramienta MIT, escrita en Python, con más de 1.3k estrellas en GitHub.
Cuando procesas un libro, la herramienta genera esta estructura:
~/.claude/skills/<slug>/
├── SKILL.md — modelos mentales + índice (~4k tokens)
├── chapters/ — archivos por capítulo (~1k cada uno)
├── glossary.md — glosario de términos (~1.5k tokens)
├── patterns.md — patrones recurrentes del libro (~2k tokens)
└── cheatsheet.md — referencia rápida (~1k tokens)
La lógica de diseño es importante: los archivos no se cargan todos juntos. Claude los accede por partes según lo que necesite en cada momento. Así, un libro de 400 páginas no bloquea tu ventana de contexto en cada conversación.
Opción rápida (natural language): Pega esto directamente en Claude Code:
Install book-to-skill: https://raw.githubusercontent.com/virgiliojr94/book-to-skill/master/SKILL.md
Opción manual:
mkdir -p ~/.claude/skills/book-to-skill/scripts
curl -o ~/.claude/skills/book-to-skill/SKILL.md \
https://raw.githubusercontent.com/virgiliojr94/book-to-skill/master/SKILL.md
curl -o ~/.claude/skills/book-to-skill/scripts/extract.py \
https://raw.githubusercontent.com/virgiliojr94/book-to-skill/master/scripts/extract.py
| Formato | Motor de extracción |
|---|---|
| PDF técnico (tablas, código) | Docling |
| PDF texto continuo | pdftotext → PyPDF2 → pdfminer (fallbacks) |
| EPUB | ebooklib + beautifulsoup4 |
| DOCX | python-docx |
| MOBI / AZW | Calibre ebook-convert |
| HTML | beautifulsoup4 |
| RTF | striprtf |
| Texto plano / Markdown | stdlib (sin dependencias externas) |
PDFs escaneados sin texto extraíble no están soportados: hay que pasarlos primero por OCR antes de procesarlos.
La sintaxis base es:
/book-to-skill <ruta-al-libro> [slug-opcional]
Si no se especifica slug, la herramienta genera uno a partir del nombre del archivo.
Convertir un PDF técnico:
/book-to-skill ~/Downloads/designing-data-intensive-apps.pdf
Usa Docling por defecto para preservar tablas y bloques de código.
Convertir un EPUB con nombre personalizado:
/book-to-skill ~/books/atomic-habits.epub habitos
Una vez que el skill está instalado, se invoca así:
/designing-data-intensive-apps — carga los modelos mentales
/ddia replicacion — busca un tema dentro del libro
/ddia ch05 — carga el capítulo 5
/ddia "¿cuándo usar replicación síncrona?" — consulta abierta
Estos son los patrones más útiles para el día a día:
1. Buscar dentro de un libro ya instalado
/<slug> <tema>
Devuelve fragmentos relevantes con referencia al capítulo de origen. Útil cuando recuerdas vagamente que "algo sobre precios estaba en el capítulo 3".
2. Resumir un capítulo específico
/<slug> ch<número>
Genera un resumen en bullets con conceptos clave y preguntas de autoevaluación. Sirve para repasar antes de aplicar lo aprendido.
3. Comparar dos libros Carga dos skills simultáneamente y pide a Claude que compare cómo cada autor aborda el mismo tema. Por ejemplo, cómo dos libros distintos de management definen la delegación efectiva.
4. Activar skill antes de una tarea
Carga el skill de <slug> antes de responder esta pregunta
Claude consultará el libro como referencia explícita durante la tarea, citando la fuente.
5. Convertir manuales de producto en habilidades de soporte Un manual técnico de 200 páginas convertido en skill permite que Claude responda preguntas de soporte consultando la documentación oficial, sin necesidad de pegar fragmentos manualmente en cada sesión.
6. Operar SOPs como base de conocimiento Procedimientos operativos estándar en DOCX o PDF se convierten en skills consultables. Especialmente útil en equipos que trabajan con checklists y protocolos repetibles.
7. Aplicar libros de soft skills en tiempo real Un libro sobre negociación o comunicación instalado como skill permite que Claude lo referencie mientras revisa emails, propuestas o scripts de ventas.
~/.claude/skills/. No es el lugar adecuado para contratos, datos de clientes o documentación bajo NDA.La diferencia con simplemente guardar un resumen en texto es que la estructura generada es consultable de forma granular. Claude no carga el libro completo en cada conversación; accede al índice en SKILL.md y decide qué archivos adicionales necesita según la consulta. Un libro de bases de datos no consume tokens cuando estás trabajando en diseño de interfaz.
Esto lo diferencia de sistemas RAG más complejos que requieren vectores, embeddings y bases de datos externas. Aquí todo vive como archivos locales en markdown, sin dependencias de infraestructura.