Book to Skill: convierte cualquier libro en una skill de Claude Code

Tienes libros técnicos que releíste tres veces y sigues sin recordar el framework exacto cuando lo necesitas. O peor: sabes que la respuesta está en algún capítulo de ese PDF de 400 páginas, pero no vas a buscarlo en mitad del trabajo.

¿Y si Claude Code pudiera hacerlo por ti? No un resumen genérico, sino una skill estructurada que extrae los frameworks, principios y técnicas del libro, y que el agente consulta bajo demanda mientras trabajas. Pides "aplica el principio de reciprocidad de Cialdini a mi landing page" y Claude sabe exactamente qué hacer, porque tiene el contenido del libro indexado.

Eso es book-to-skill: una skill open-source que convierte cualquier libro (PDF, EPUB, DOCX, Markdown y más) en una skill reutilizable para Claude Code. En este tutorial te enseño a instalarla, usarla y sacarle partido de verdad.

¿Qué es book-to-skill?

Book-to-skill es una skill creada por Virgilio Jr. que hace una cosa brillante: toma un libro o documento, lo procesa con un script Python, y genera una colección de archivos Markdown que Claude Code puede consultar como si fueran su propia base de conocimiento.

No es un resumen. No es copiar y pegar el libro. Es una extracción estructurada que convierte 300 páginas en:

• Un SKILL.md maestro con los frameworks más importantes del autor
• Un archivo por capítulo con conceptos clave, modelos mentales y anti-patrones
• Un glosario de términos
• Un catálogo de patrones y técnicas
• Una cheatsheet de referencia rápida

Y lo mejor: Claude carga los archivos bajo demanda. No gasta tokens leyendo todo el libro cada vez. Solo carga el capítulo relevante cuando lo necesitas.

¿Por qué convertir libros en skills?

Yo tengo estanterías llenas de libros que leí, subrayé, y cuyos frameworks olvidé en dos semanas. El conocimiento estaba ahí, pero no era accesible en el momento que lo necesitaba. Convertirlos en skills cambia eso por completo.

Requisitos previos

Antes de instalar, necesitas tener esto:

Dependencias opcionales (el script te avisa si las necesitas):

• pdftotext (poppler-utils): mejor extractor de PDF. brew install poppler en macOS.
• ebooklib + beautifulsoup4: para EPUB con formato. pip install ebooklib beautifulsoup4
• python-docx: para DOCX con estructura. pip install python-docx
• Calibre: para MOBI/AZW (Kindle). Instalar desde calibre-ebook.com
• Docling: para PDF técnicos con tablas y código. pip install docling

No te preocupes si no tienes todas: el script tiene fallbacks para cada formato y te pregunta antes de instalar nada.

Instalación paso a paso

Eso es todo para la instalación. En serio, un comando.

Tu primera conversión: de libro a skill

Vamos a convertir un libro real. Abre Claude Code y escribe:

Claude arranca el workflow de 10 pasos. Lo primero que hace es preguntarte qué tipo de libro es:

Claude extrae el texto, analiza la estructura y te muestra una estimación de coste antes de generar nada:

Si dices que sí, Claude procesa cada capítulo, extrae frameworks, genera los archivos, y al final te da un resumen:

A partir de ahora, en cualquier sesión futura de Claude Code, puedes pedir cosas como "aplica el principio de escasez de Cialdini a mi copy" y Claude sabe exactamente qué hacer.

¿Qué genera exactamente?

Después de la conversión, la skill tiene esta estructura:

¿Qué hay dentro de cada archivo de capítulo?

Cada capítulo sigue una estructura fija que Claude puede navegar rápido:

• Core Idea: la idea central del capítulo en 1-2 frases
• Frameworks Introduced: frameworks con nombre exacto del autor, cuándo usarlos y cómo
• Key Concepts: 5-10 términos definidos con precisión
• Mental Models: herramientas de pensamiento en formato "Usa X cuando Y"
• Anti-patterns: qué evitar y por qué falla
• Code Examples: solo en libros técnicos (código real del libro)
• Key Takeaways: 3-7 insights accionables
• Connects To: relaciones con otros capítulos y conceptos externos

La clave es que no son resúmenes narrativos. Son herramientas de pensamiento que Claude puede aplicar directamente a tu trabajo.

El problema de tokens que resuelve

Cuando intentas que un agente trabaje con un libro, hay tres enfoques habituales. Los tres tienen problemas serios.

Opción 1: volcar el libro entero en contexto. Un libro de 300 páginas son 120.000-180.000 tokens. Cada vez que haces una pregunta, pagas esa factura completa. Con un libro de ingeniería de software son fácilmente 250K tokens por consulta. A $3 por millón de tokens de entrada, la cuenta sube rápido.

Opción 2: buscar trozo a trozo. Le dices a Claude "busca en el libro la parte sobre testing" y el agente va abriendo secciones, leyendo, descartando, probando otra. Este enfoque "de descubrimiento" gasta entre 12.000 y 78.000 tokens por consulta dependiendo de lo rápido que encuentre lo que buscas. Mejor que volcar todo, pero sigue siendo caro y lento.

Opción 3: no usar el libro. La más común. Tienes el libro, sabes que tiene la respuesta, pero el coste o la fricción te frena. El conocimiento se queda en la estantería.

Book-to-skill introduce una cuarta vía: compilar el conocimiento una sola vez. La skill generada tiene un SKILL.md de ~4.000 tokens que siempre está cargado, más capítulos individuales de ~1.000-1.800 tokens que se cargan solo cuando hacen falta. Resultado: cada consulta consume unos 5.000-6.000 tokens en vez de 120.000+.

Para ponerlo en perspectiva con números reales:

Y esa ventaja escala con el tamaño del libro. Cuanto más grande y denso es el libro, mayor es la diferencia. Con un manual técnico de 600 páginas, la skill puede ser 50 veces más eficiente que el volcado directo. Es la diferencia entre rebuscar en un cajón sin orden y consultar un archivo con pestañas bien puestas.

Los 3 modos de uso

Mi recomendación: para libros que ya conoces, usa Full Conversión directamente. Para libros nuevos o muy largos (500+ páginas), haz primero "analyze only" para ver si la estructura se detecta bien, y luego genera.

Cómo consultar una skill generada

Una vez generada, la skill está disponible en todas tus sesiones de Claude Code. No necesitas activarla ni importarla. Simplemente habla con Claude y referencia el contenido:

Formas de consultar

• Por tema: "¿Qué dice el libro sobre social proof?"
• Por capítulo: "Resúmeme el capítulo 5"
• Aplicado a tu trabajo: "Aplica el framework de autoridad a mi perfil de LinkedIn"
• Referencia cruzada: "¿Qué técnicas del libro aplican a email marketing?"
• Exploración: "¿Qué capítulos tiene la skill de Cialdini?"

Claude carga solo el capítulo relevante, no toda la skill. Por eso el coste por consulta es mínimo.

Más allá de libros: carpetas, papers y docs internos

Book-to-skill no se limita a un solo archivo. Puedes pasarle carpetas enteras, patrones glob, o múltiples documentos que se fusionan en una skill unificada.

Esto abre casos de uso que van más allá de los libros:

• Documentación interna dispersa: ADRs, guías de estilo, runbooks, postmortems. 40 archivos Markdown que nadie recuerda dónde están, unificados en una skill con índice navegable.
• Papers de investigación: 10 papers sobre fine-tuning fusionados con glosario cruzado y referencias entre ellos.
• Specs y estándares: RFCs, guías de accesibilidad, normativa RGPD. Documentos que consultas fragmentariamente pero nunca enteros.
• Manuales técnicos: la documentación oficial de un framework que usas a diario y medio recuerdas.

Cuando le pasas una carpeta, el script procesa cada archivo por separado y fusiona los resultados en un único SKILL.md con glosario, patrones y cheatsheet compartidos.

Fold-in: añadir contenido a una skill existente

¿Ya tienes una skill generada y quieres añadirle un documento nuevo sin regenerar todo? El modo fold-in hace exactamente eso.

El proceso es inteligente: lee el SKILL.md existente, detecta la numeración actual de capítulos, y añade los nuevos sin romper los anteriores. El glosario, patrones y cheatsheet se fusionan alfabéticamente.

Esto convierte la skill en una base de conocimiento viva. Cada vez que lees un paper nuevo, un ADR reciente, o una guía actualizada, lo incorporas a la skill existente con un solo comando. Con el tiempo, acumulas una biblioteca personal que Claude puede consultar al instante.

Formatos soportados y extractores

Si un extractor no está instalado, el script te pregunta: "Missing package detected. Do you want to install? y=install, n=fallback". Puedes elegir instalar o usar el fallback stdlib que viene incluido.

¿Por qué esto y no un RAG?

Si conoces RAG (Retrieval Augmented Generation), te estarás preguntando: ¿no es esto lo mismo? No. Son enfoques fundamentalmente distintos.

RAG tiene sentido cuando trabajas con datos que cambian constantemente (logs, tickets, conversaciones). Pero para un libro o documentación estable, compilar una vez y consultar gratis es objetivamente mejor. No necesitas montar Qdrant, generar embeddings, ni mantener un pipeline. Solo archivos Markdown que cualquier agente sabe leer.

Además, RAG devuelve trozos de texto. Book-to-skill devuelve conocimiento procesado: "usa X cuando Y" en vez de "en la página 147 el autor menciona que...". Eso marca la diferencia cuando quieres que Claude aplique un framework a tu trabajo en vez de simplemente citarte un párrafo.

¿Cuánto cuesta en tokens?

Book-to-skill es gratis y open-source. El coste real es el consumo de tokens de Claude al procesar el libro. Aquí van números reales:

Para libros largos (500+ páginas), la skill usa un enfoque inteligente: en vez de leer el libro entero en memoria, hace consultas quirúrgicas con grep y sed para cargar solo el capítulo que está procesando. Esto mantiene el coste proporcional al output, no al tamaño del libro.

3 ejemplos reales

Ejemplo 1: libro de marketing

Genera una skill con los 7 pasos del framework StoryBrand. Después puedes pedir: "Aplica el framework StoryBrand a la página de inicio de mi proyecto." Claude estructura tu copy siguiendo los 7 pasos del libro.

Ejemplo 2: libro técnico de programación

Al preguntar por tipo de libro, elige "Technical". Docling preserva las tablas de comparación (LSM-Tree vs B-Tree), los diagramas de arquitectura en texto, y los fragmentos de código. Consulta: "¿Qué patrón de replicación recomienda Kleppmann para mi caso de uso con Postgres?"

Ejemplo 3: libro de productividad

Extrae las 4 reglas de Deep Work, las estrategias de scheduling, y los anti-patrones de distracción. Consulta: "Diseña mi rutina diaria aplicando las reglas de Deep Work de Newport."

9 consejos para mejores resultados

1. Usa PDFs de buena calidad. Los PDFs escaneados (imágenes sin OCR) dan mal resultado. Si tu PDF es un escaneo, pásalo primero por un OCR como Adobe Acrobat u OCRmyPDF.
2. Para libros técnicos, elige siempre "Technical". Docling tarda más (1.5 segundos por página), pero preserva tablas y código que pdftotext destruye. Un libro técnico sin sus tablas es una skill que suena bien pero no sirve.
3. Haz "analyze only" primero con libros nuevos. Te muestra los frameworks detectados antes de gastar tokens en la generación completa. Si la estructura del libro es irregular, puedes ajustar.
4. Nombra las skills con el formato autor-concepto. cialdini-influence, newport-deep-work, kleppmann-data-intensive. Es más fácil de recordar y referenciar que un slug genérico.
5. Un libro por skill, pero usa fold-in para documentos relacionados. Un libro grande merece su propia skill. Pero papers o artículos sobre el mismo tema pueden ir juntos con fold-in.
6. Revisa siempre el SKILL.md generado. Claude a veces confunde nombres de frameworks, mezcla conceptos similares, u omite secciones importantes. Cinco minutos de revisión manual mejoran mucho la calidad de las consultas futuras. Compara con el índice del libro original.
7. Combina skills. Lo potente es tener varias skills activas. "Aplica reciprocidad de Cialdini usando el framework StoryBrand para mi onboarding." Claude cruza ambas skills sin que le digas dónde buscar.
8. Los libros con frameworks con nombre dan mejores skills. "Las 5 fuerzas de Porter", "el principio de Pareto", "la regla de los 2 minutos". Cuanto más estructurado y nombrado está el contenido del autor, mejor es la extracción. Libros tipo ensayo narrativo sin frameworks explícitos producen skills mediocres.
9. No olvides la documentación interna. Las mejores skills que he generado no son de libros famosos, sino de documentación interna: ADRs, guías de arquitectura, runbooks de producción. Conocimiento que ya existía pero que nadie consultaba porque estaba disperso en 30 archivos.

Limitaciones

Siendo honestos sobre lo que no hace bien:

• No procesa imágenes ni diagramas. Si el valor del libro está en gráficos y diagramas, la skill no los captura. Solo texto.
• PDFs escaneados sin OCR: texto ilegible o vacío. Necesitas OCR previo.
• Libros con estructura irregular: si el libro no tiene capítulos claros (algunos libros de ensayo, poesía), la detección de estructura falla. Funciona mejor con libros bien organizados.
• Libros muy largos (800+ páginas): funcionan, pero el coste en tokens sube y el tiempo de procesamiento puede superar los 20 minutos.
• Contenido con copyright: la skill extrae y sintetiza, no copia texto literal. Pero ten en cuenta las implicaciones legales de procesar contenido protegido para uso personal vs. distribución.
• Calidad variable por formato: PDF con tablas complejas o layouts de dos columnas pueden perder estructura. EPUB y Markdown dan los mejores resultados consistentes.

¿Y si no uso Claude Code?

Book-to-skill también funciona con otros agentes:

• Amp: clona en ~/.config/agents/skills/book-to-skill
• GitHub Copilot CLI: clona en ~/.copilot/skills/book-to-skill
• Cualquier agente compatible: clona en ~/.agents/skills/book-to-skill

La skill generada son archivos Markdown estándar. Si tu herramienta soporta leer archivos Markdown como contexto, puedes usarla. No hay dependencia de ningún agente específico.

¿Dónde consigo libros gratuitos para convertir en skills?

Book-to-skill funciona con cualquier PDF, EPUB o DOCX que tengas. Pero si estás empezando y no sabes por dónde buscar material legal y gratuito, aquí va un framework de búsqueda que he destilado investigando a fondo los recursos disponibles en GitHub y fuera de él.

El framework: 3 niveles de confianza

No todos los "libros gratuitos" tienen el mismo nivel de seguridad jurídica. He organizado las fuentes en tres niveles para que sepas exactamente dónde pisas:

Regla de oro: empieza por el índice curado (nivel B), localiza la obra que te interesa, y termina la verificación en la fuente del autor (nivel A). Nunca uses un repo de tercero como fuente primaria sin comprobar la licencia original.

Paso 1: tu punto de partida

El mejor catálogo de libros técnicos gratuitos que existe se llama Free Programming Books, mantenido por la Free Ebook Foundation. Tiene cerca de 395.000 estrellas en GitHub, contribuciones activas en 2026, y su índice está bajo CC BY 4.0. Incluye una sección en español con libros de IA, Git, JavaScript, Python, sistemas operativos y desarrollo web.

Pero recuerda: la licencia CC BY 4.0 cubre el catálogo, no cada libro enlazado. Cada obra tiene su propia licencia que debes comprobar antes de usarla.

Paso 2: libros verificados listos para convertir

Estos son libros que he verificado personalmente: fuente oficial, licencia explícita, formatos disponibles y estado actual confirmado. Puedes descargarlos y pasarlos por book-to-skill con tranquilidad, siempre respetando las condiciones de cada licencia.

Programación y desarrollo

Ciencia de datos y estadística

Ciencia abierta y metodología

Paso 3: convertir a skill

Una vez que tienes el libro descargado y su licencia verificada, el proceso es directo:

Paso 4: verificar licencias (checklist rápido)

Antes de convertir cualquier libro, pasa por esta checklist:

1. ¿Quién lo pública? Busca el repositorio del autor o proyecto original, no una copia de terceros.
2. ¿Hay archivo LICENSE o licencia en el README? Si no hay ninguno, el copyright aplica por defecto. No puedes asumir que es libre.
3. ¿Qué licencia exacta es? CC BY permite casi todo con atribución. CC BY-NC prohíbe uso comercial. CC BY-SA obliga a compartir igual. Sin versión especificada, desconfía.
4. ¿Es la fuente o una copia? Un PDF en el repo de otra persona no hereda la licencia de ese repo. Busca siempre la edición original.
5. ¿Tu uso es personal o vas a distribuir? Para uso personal con libros que compraste, el riesgo es mínimo. Para redistribuir la skill generada, necesitas que la licencia lo permita explícitamente.

Paso 5: catálogos curados por tema

Más allá de Free Programming Books, hay catálogos especializados que funcionan como semillas de búsqueda. Todos son índices que enlazan a fuentes externas, así que la licencia de cada libro sigue requiriendo verificación individual.

IA y Machine Learning

Ciberseguridad

Paso 6: libros oficiales de autores (las joyas)

Los mejores candidatos para skills son libros que los propios autores o sus editoriales publican gratuitamente. Aquí no hay ambigüedad de licencia: el autor decidió que quiere que los leas gratis. He recopilado los más relevantes por dominio.

IA y Machine Learning

• Dive into Deep Learning (D2L): libro interactivo oficial con código, matemáticas y múltiples formatos. Uno de los mejores recursos de DL que existen. Perfecto para una skill de arquitecturas y técnicas de deep learning.
• Deep Learning Book (Goodfellow, Bengio, Courville): el clásico. Lectura gratuita oficial online. Ideal para una skill de fundamentos teóricos de DL.
• Understanding Deep Learning (Simon J. D. Prince): publicado oficialmente por el autor. Enfoque más moderno y visual que el de Goodfellow.
• The Little Book of Deep Learning (François Fleuret): edición actualizada por el autor. Compacto y denso. Perfecto para una skill de referencia rápida.
• An Introduction to Statistical Learning (ISLR): disponible oficialmente por los autores. El punto de entrada estándar a ML estadístico.
• Elements of Statistical Learning (ESL): disponible oficialmente desde Stanford. Más avanzado que ISLR.
• Speech and Language Processing, 3.ª ed. (borrador): borrador oficial de Jurafsky y Martin. La referencia en NLP.
• Mathematics for Machine Learning: versión oficial gratuita. Cubre el álgebra lineal, cálculo y probabilidad que necesitas para ML.

Ciberseguridad y Reverse Engineering

• Security Engineering, 3.ª ed. (Ross Anderson): disponible oficialmente en la web del autor. Enciclopédico. Perfecto para una skill de principios de seguridad.
• Reverse Engineering for Beginners (Dennis Yurichev): libro gratuito oficial. El punto de entrada estándar a RE.
• OWASP Web Security Testing Guide: documentación/libro abierto oficial de OWASP. Imprescindible para una skill de pentest web.
• OWASP API Security Top 10: publicación oficial. Compacto y directo.
• MISP Book / MISP Training: material oficial de threat intelligence e intercambio de IOCs.
• The Threat Intelligence Handbook (Recorded Future): distribuido gratuitamente desde su sitio oficial.

Todos estos libros tienen en común que el autor o la institución los pública activamente de forma gratuita. Son candidatos ideales para book-to-skill: contenido de calidad, licencia clara, y formatos descargables.

Cómo detectar repos que no debes usar

En GitHub vas a encontrar repositorios que parecen bibliotecas gratuitas pero en realidad alojan copias no autorizadas de libros comerciales. Estas son las señales de alarma:

1. El archivo LICENSE solo cubre el código o el README, pero el repo está lleno de PDFs de editoriales (O'Reilly, Packt, Wiley, No Starch, Pearson, Manning).
2. El README dice "collected from the Internet", "for educational purposes only", o "contact me for removal". Esas frases son un reconocimiento implícito de que no tienen derechos.
3. Enlaces a Google Drive, Mega, o servicios similares con colecciones de PDFs. Las editoriales legítimas no distribuyen así.
4. Decenas o cientos de PDFs de libros comerciales en una sola carpeta. Ningún autor pública así su propia obra.
5. Nombres de archivo con ISBN o edición comercial sin licencia acompañante.
6. Repo con licencia MIT/Apache que no puede aplicarse al contenido editorial de terceros. La licencia del repo cubre el código del repo, no los PDFs que alguien subió dentro.

Si ves alguna de estas señales, no uses ese contenido. Busca el título que te interesa en la web del autor o la editorial. Muchos libros técnicos tienen versiones gratuitas oficiales que los propios autores distribuyen.

Recursos universitarios en inglés (fallback de calidad)

Si no encuentras lo que buscas en español, OpenStax (Rice University) ofrece manuales universitarios completos y gratuitos en inglés, con licencia Creative Commons. Cubren cálculo, estadística, física, biología y más. Claude trabaja igual de bien con skills en inglés y puede responderte en español.