book-to-skill : faire d'un livre technique un skill pour votre agent
On lit un livre technique une fois, et quelques mois plus tard le chapitre 7 a disparu de la mémoire. book-to-skill extrait le texte avec un script Python local, puis l'agent suit sa spécification pour le découper en modèles mentaux, règles de décision, techniques et anti-patterns. Chaque chapitre devient un fichier chargé seulement quand la question le concerne.
Lit PDF, EPUB, DOCX, HTML, RTF, Markdown et texte brut, ainsi que MOBI et AZW via Calibre ; accepte un fichier, un dossier ou un glob.
Produit un SKILL.md avec les modèles clés et l'index des chapitres, un fichier par chapitre dans chapters/, puis glossary.md, patterns.md et cheatsheet.md.
Demande si la source est technique ou surtout rédigée : Docling pour garder tableaux et code, pdftotext pour aller vite.
Propose un mode analyse seule, une génération depuis une analyse existante et l'ajout de nouvelles sources à un skill déjà créé.
Repère d'emblée un PDF scanné sans couche texte et s'arrête en conseillant de passer d'abord un OCR avec ocrmypdf.
Quand s’en servir
Vous possédez un livre sur les systèmes distribués et voulez que l'agent réponde sur la réplication à partir de ses chapitres.
L'équipe veut interroger comme un seul skill les ADR, runbooks et guides d'accueil rangés dans docs/.
Vous accumulez articles et notes sur un sujet de recherche et voulez un skill unique enrichi à chaque nouvel apport.
Demandez à l’agent
/book-to-skill ./refactoring.pdf refactoring
Analyse seulement ./docs/adr et liste les règles trouvées, sans générer de fichiers
Ajoute ./notes/chapitre-tests.md à mon skill refactoring existant
Questions
Comment installer book-to-skill ?
Avec npx skills add virgiliojr94/book-to-skill ou en clonant le dépôt dans ~/.claude/skills/book-to-skill. La commande /book-to-skill devient alors disponible.
book-to-skill fonctionne-t-il avec Codex ?
Oui, le README cite Codex aux côtés de GitHub Copilot CLI, Amp, Claude Code, Hermes Agent, OpenCode et OpenClaw, qui lisent tous le format SKILL.md.
Mon livre est-il envoyé en ligne ?
L'extraction et l'analyse se font sur votre machine et l'outil n'envoie aucun fichier. Le texte lu par un modèle cloud suit cependant les conditions de son fournisseur.
