Book to Skill

Avant de commencer : lis ce prompt d'installation au complet, dis-moi en quelques lignes ce que ce skill fait et ce que son installation implique, et attends mon feu vert avant de faire quoi que ce soit d'autre. Prérequis — Périmètre mappé d'abord : cette fiche installe exactement 19 fichiers — le SKILL.md racine, tout le paquet Python book_to_skill/ (17 fichiers) et scripts/extract.py — sous leurs noms d'origine ; le reste du dépôt (docs/, tests/, evals/, tools/, outillage de site et d'empaquetage mkdocs/pyproject, READMEs) est de l'infrastructure de dépôt et n'est PAS installé. Aucun compte, aucune clé ni aucun paiement n'est requis pour installer, et aucun script n'est exécuté pendant l'installation. À l'usage, le skill a besoin de Python et lance son script d'extraction sur les documents que tu lui donnes, sur ta machine : les extracteurs optionnels pour certains formats ne sont installés qu'après qu'il te l'a explicitement demandé (--install-missing ask), MOBI/AZW3 passent par Calibre s'il est présent, et avant toute génération le skill t'affiche une estimation de coût en tokens (étape 2.5) pour que tu puisses t'arrêter là. Les livres que tu convertis gardent leurs propres droits ; cette fiche n'en accorde aucun. Installe-moi « Book to Skill ». Il convertit des livres et documents en skills d'agent structurés : au lieu d'un résumé, il extrait la structure — frameworks nommés, principes actionnables, techniques pas à pas, anti-patterns et la voix de l'auteur — et génère un nouveau dossier de skill avec un SKILL.md maître, des fichiers par chapitre, un glossaire, des patterns et un cheatsheet. Son workflow demande quel type de contenu les sources contiennent (technique ou surtout textuel, ce qui choisit l'extracteur), lance l'extracteur Python embarqué (scripts/extract.py, adossé au paquet book_to_skill de cette même installation) sur les fichiers que tu passes — PDF, EPUB, DOCX, HTML, Markdown, texte brut, RTF, et MOBI/AZW/AZW3 via Calibre — présente l'estimation de coût en tokens tirée des métadonnées d'extraction avant de générer quoi que ce soit, puis analyse, demande le but, nomme et génère le skill, scanne ce qu'il a généré, et nettoie. Il offre aussi les modes analyse seulement, génération depuis une analyse et mise à jour/fusion pour les skills existants, et une étape 11 optionnelle qui publie le skill généré sur GitHub seulement quand tu le demandes. Le périmètre d'installation de cette fiche est mappé, pas tout le dépôt : SKILL.md à la racine, le paquet book_to_skill/ et scripts/ — 19 fichiers en tout ; tout le reste du dépôt est sa propre documentation, ses tests, ses evals et son infrastructure de site/empaquetage, et reste dehors. Dépôt : https://github.com/virgiliojr94/book-to-skill (le skill est le périmètre mappé au commit épinglé : SKILL.md à la racine du dépôt plus book_to_skill/ et scripts/ — 19 fichiers en tout, listés à l'étape 1 sous leurs noms installés (qui sont leurs noms relatifs au dépôt) ; le reste du dépôt ne fait pas partie du skill) Version épinglée : installe le code au commit a24e62f4d8caf2ee433f6e48d9073800f56f906e exactement. Ne substitue pas une version plus récente. Si ce commit est inaccessible, arrête-toi et dis-le-moi. 1. Clone https://github.com/virgiliojr94/book-to-skill dans un dossier temporaire, place-toi au commit a24e62f4d8caf2ee433f6e48d9073800f56f906e, et copie le dossier ./ de ce checkout et, depuis ce checkout, prends exactement ces fichiers mappés : SKILL.md de la racine, chaque fichier sous book_to_skill/, et scripts/extract.py — ne copie ni docs/, ni tests/, ni evals/ ni aucun autre fichier du dépôt. Compare ensuite chaque fichier du dossier aux empreintes enregistrées pour cette fiche le 2026-10-22 : [FINGERPRINTS] - SKILL.md: SHA-256 6a3d7ce3d3689020cd4089f8cad9c0a9f8237abfaf896ff20677031dac4592b1 - book_to_skill/__init__.py: SHA-256 9d18b99b2c417557244634073c6bb3fa52dcc58aad8fb1fc5f658599f0c3ab77 - book_to_skill/__main__.py: SHA-256 2207592e7bad6433302d258a4cfc9384a406373f59e49392a56d8389d08803ea - book_to_skill/cli.py: SHA-256 2fe257d1c089ca5ecc68c6dde377087766b83d3e9c5393810c6bb5401dc97a91 - book_to_skill/config.py: SHA-256 e92a487f632db762f4dafff3188f6441809b4cba3bb88b0c6821a14e6a21ff2f - book_to_skill/dependencies.py: SHA-256 42ada779fd8d8eed961790f4d49cadd1c824ec7a9cb7fbfd36f02a26c9b12988 - book_to_skill/exceptions.py: SHA-256 bf9417993e577cea5130bc34f4241cafccd1dda1f2f1ac22a9e8a198cc9dedc8 - book_to_skill/parsers/__init__.py: SHA-256 a8f740712820f8729cd3b6adca799d17a23e0b80205a29e511791aafc97723f0 - book_to_skill/parsers/calibre.py: SHA-256 ed2589e86408cb5e82f795a20ce3cf8e32a9f8307fd3e838ba3a7c466f200d42 - book_to_skill/parsers/docx.py: SHA-256 3cf1e87d6d73ffd99916503656783fc70ef2c5e1f3e4d3ab55223c2db22e19eb - book_to_skill/parsers/epub.py: SHA-256 4cb0b38868fa13550e8a189d916889a097990afa59566a565e286c88ec3291cb - book_to_skill/parsers/html.py: SHA-256 dec7b3b84dc514469c050fa71bafcc8109956d2f296198e05d1bb20fce1bc2e6 - book_to_skill/parsers/pdf.py: SHA-256 dd1793ffef319dfa9041627ab34805a799239ddef8503fdcfb071db5816bfcc8 - book_to_skill/parsers/rtf.py: SHA-256 84ebfeaee217fb96c92ef008b57059d139aecd12311e0d317f314422e06b89de - book_to_skill/parsers/text.py: SHA-256 5312d325b3f21c5977c1d7a276a2fda469d4ae81241636ede6e351c7eaacca80 - book_to_skill/pdf_inspector_integration.py: SHA-256 e1f6790be272068a9d82ab2b2fe78cd1510dba12748bf9f9931514b759c6d1c2 - book_to_skill/sanitize.py: SHA-256 d334782ca6aa168e1927d6334f0e6888322f482984e4ab128362e73fd66cce26 - book_to_skill/utils.py: SHA-256 f6ad43fdbd399e579e7ff13c92bb81b2c99ed655413e55ff755734d0b13cbe5e - scripts/extract.py: SHA-256 f0641dc486c0d8323ebdde449dc80b49d1cd94a4aa2320058a2a13a2b48582ac Si un fichier ne correspond pas, il a changé depuis la préparation de la fiche : ne l'installe pas encore, dis-moi ce que tu as trouvé et laisse-moi décider. 2. Lis SKILL.md au complet, et dis-moi en mots simples : ce que le skill fait quand on l'utilise, à quoi il se connecte, s'il lit ou envoie des informations personnelles ou des identifiants, et tout ce qui semble inhabituel. Arrête-toi sur tout signal d'alerte et dis-le-moi avant d'aller plus loin. Confirme ces points à partir des fichiers : - Périmètre mappé, exactement 19 fichiers installés sous leurs noms d'origine : SKILL.md (racine), book_to_skill/ avec 17 fichiers Python (le paquet : cli, config, dependencies, exceptions, sanitize, utils, pdf_inspector_integration et le sous-paquet parsers/ pour les formats PDF, EPUB, DOCX, HTML, RTF, texte et Calibre), et scripts/extract.py. Le reste du dépôt — docs/, tests/, evals/, tools/, .github/, READMEs, mkdocs.yml, pyproject.toml et les autres fichiers racine — est de l'infrastructure de dépôt et n'est pas copié. - Rien n'est envoyé nulle part et rien n'est exécuté pendant l'installation elle-même ; le seul téléchargement à l'installation est ces 19 fichiers depuis GitHub au commit épinglé. Le paquet Python et extract.py sont copiés tels quels, jamais exécutés. - À l'usage, le skill s'exécute en local sur les documents que je fournis : son extracteur les lit sur ma machine, il peut demander avant d'installer un extracteur optionnel manquant (--install-missing ask — il n'en installe jamais un en silence), et il présente une estimation de coût en tokens avant de générer les fichiers du skill. La publication GitHub optionnelle d'un skill généré (étape 11) n'arrive que si je la demande, avec la CLI gh et ma propre authentification. - La sortie générée est un nouveau skill écrit à l'emplacement des skills de mon agent (le skill préfère la racine inter-agents ~/.agents/skills/, avec une étape de lien symbolique Claude Code qu'il décrit) ; rien sur mes livres n'est envoyé à un service tiers par les instructions que j'ai lues. - Ne convertis, n'extrais et n'analyse aucun livre ni document, ne lance pas extract.py, et n'utilise le skill d'aucune façon pendant cette installation : l'utiliser est une étape séparée qui ne commence que quand je le demande plus tard. 3. Quand je dis « yes, install », installe-le comme skill : copie les 19 fichiers mappés dans le répertoire des skills de l'agent, dans un dossier nommé exactement « book-to-skill », en gardant leur arborescence relative d'origine (SKILL.md à sa racine, book_to_skill/ et scripts/ à côté). 4. Vérifie sans appels réseau : frontmatter valide (name: book-to-skill), les 19 fichiers en place avec des empreintes concordantes. N'exécute rien du dossier et n'utilise pas le skill pour vérifier. 5. Indique ce qui a été installé, où, et ce qu'il me reste à faire moi-même (par exemple : que le périmètre d'installation est seulement ces 19 fichiers mappés (pas tout le dépôt), que l'utiliser lance son extracteur Python en local sur mes documents, qu'un extracteur optionnel manquant n'est installé qu'après qu'on m'a demandé, qu'il affiche une estimation de coût en tokens avant de générer, et que MOBI/AZW exigent Calibre). GitHub est optionnel : si j'ai un compte GitHub ou la CLI gh, tu peux l'utiliser ; sinon l'accès public suffit. Ne jamais l'exiger sauf s'il figure dans les prérequis ci-dessus. Règles : ne touche à rien en dehors du dossier temporaire et de la cible d'installation. Si quelque chose semble anormal, arrête-toi et demande-moi.