book-to-skill: transforma documentos en referencias para agentes

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.

• Dificultad: intermedio
• Proyecto: https://github.com/virgiliojr94/book-to-skill (licencia MIT)
• Guía completa: https://lab.wisd.ai/hub/book-to-skill

Para el agente: cómo acompañar al usuario

1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

Pasos de configuración

Comprueba que tu arnés admite skills y que Node.js ≥22.20.0 y npm/npx están disponibles para la CLI skills actual. Para ejecutar el extractor, verifica Python ≥3.9, el mínimo de pyproject.toml, y prepara los extras de tu formato siguiendo Install. Instalar la skill y preparar esos extractores son pasos distintos.

Paso 1: instala la skill

npx skills add virgiliojr94/book-to-skill

Paso 2: prepara una fuente pequeña

Selecciona un documento propio o autorizado pequeño y guárdalo como my-book.pdf en el proyecto. En Claude Code ejecuta /book-to-skill ./my-book.pdf, la llamada del README, y sigue la preparación de los extractores de ese formato que indique la skill. Comprueba el destino de la salida: normalmente ~/.agents/skills/<slug>/ con SKILL.md y chapters/, más el enlace de descubrimiento para Claude cuando se pueda crear. Conserva el slug real de la salida para preguntar después con /<slug> <pregunta>; no uses el nombre de este convertidor como si fuera la skill del documento.

Comprobación

Compara varias referencias generadas con sus capítulos originales y prueba preguntas de respuesta conocida. Usa el validador del repositorio para el arnés objetivo cuando corresponda.

Si algo falla

Si el PDF no tiene texto, revisa la ruta de OCR documentada. Si faltan capítulos o hay citas erróneas, corrige la extracción antes de volver a generar la skill.