Kniha, ktorú si prečítal, sa dá nainštalovať. book-to-skill z nej spraví plnohodnotný Claude skill: hlavné myšlienky, kapitoly, slovník pojmov, techniky aj cheatsheet na rozhodovanie. Claude si potom pri otázke načíta len to, čo potrebuje, a odpovedá priamo z knihy, nie z hlavy. Nie je to sumár knihy, je to jej štruktúra: pomenované modely, pravidlá a chyby, ktorým sa treba vyhnúť, presne tak ako by ich vedel vysvetliť autor.
Prečo skill a nie len PDF hodené do chatu
Prvý inštinkt je pribaliť PDF priamo do konverzácie. Funguje to, ale má to cenu, ktorú väčšina ľudí neráta:
- 400-stranová kniha je zhruba 200 000 tokenov. Keď ju priložíš do chatu, platíš túto sumu pri každej jednej otázke, v každej konverzácii, navždy. Skill zaplatí extrakciu raz a od druhej otázky sa načíta len konkrétna kapitola, spolu asi 5 000 tokenov. Na reálnych knihách to autor nameral: 24 až 51-krát menej tokenov na odpoveď oproti hodenému PDF.
- Väčšie kontextové okno (1M tokenov) to nerieši. Mení to, čo sa zmestí, nie čo je šikovné. Stále platíš za každý token pri každom volaní, a model má horšiu presnosť keď hľadá jeden konkrétny fakt v takmer plnom okne (tzv. "lost in the middle"). Kúsok knihy vytiahnutý cielene poráža 200-tisíc slov surového textu.
Inštalácia
Potrebuješ Claude Code (terminálová appka od Anthropicu). Ak ju máš, celá inštalácia je jeden príkaz:
npx skills add virgiliojr94/book-to-skill
Čo sa stane: príkaz stiahne skill aj so všetkými pomocnými skriptami a uloží ho do priečinka, kde ho Claude Code hľadá (~/.claude/skills/book-to-skill). Otvor si novú Claude Code session (existujúcu netreba reštartovať, stačí ďalšia) a pribudne ti príkaz /book-to-skill.
Rovnaký jeden príkaz funguje aj keď namiesto Claude Code používaš GitHub Copilot CLI, Amp, Codex alebo Hermes Agent, skill beží na otvorenom Agent Skills štandarde a nie je viazaný na jeden nástroj.
Alternatíva bez npx: ak nechceš spúšťať cudzí balík cez npx, stačí Claude Code rovno požiadať, nech si skill nainštaluje sám. Skopíruj a vlož do Claude Code session presne túto vetu:
Install book-to-skill: https://raw.githubusercontent.com/virgiliojr94/book-to-skill/master/SKILL.md
Claude si stiahne definíciu skillu z toho odkazu a sám sa postará o zvyšok inštalácie. Výsledok je identický ako pri npx skills add, len bez medzikroku cez node balíček.
Ako to funguje pod kapotou
Keď spustíš /book-to-skill, deje sa toto:
- Extrakcia textu. Skill sa najprv opýta, či je kniha skôr technická (kód, tabuľky) alebo textová (próza, teória). Podľa toho zvolí nástroj: rýchly
pdftotextpre bežný text (pár sekúnd na celú knihu), aleboDoclingpre technické knihy, ktorý navyše zachytí tabuľky a kód ako poriadny markdown (pomalšie, ale nič sa nestratí). - Rozpoznanie štruktúry. Claude prejde vytiahnutý text a nájde názov, autora, kapitoly a obsah.
- Kapitoly, glosár, patterns, cheatsheet. Ku každej kapitole vznikne samostatný súhrn (800-1 200 tokenov), technické knihy dostanú navyše sekcie s príkladmi kódu a tabuľkami. K tomu pribudne spoločný glosár pojmov, súbor s technikami/vzormi a cheatsheet, čo je najužitočnejšia časť: nie je to zoznam definícií, ale rozhodovacie pravidlá, presne to, ako by sa rozhodol autor.
- Hlavný SKILL.md. Zbalí kľúčové mentálne modely na začiatok (prvých ~5 000 tokenov), aby ostali v kontexte aj keď sa konverzácia dlho naťahuje.
Výsledok sa uloží do ~/.claude/skills/<nazov-knihy>/ a odteraz sa načítava len na požiadanie, kapitola po kapitole, nikdy naraz celá kniha.
Použitie
/book-to-skill <cesta-k-suboru-priecinku-alebo-globu>... [nazov-skillu]
Podporuje PDF, EPUB, DOCX, TXT, Markdown, reStructuredText, AsciiDoc, HTML, RTF aj MOBI/AZW.
# jedna kniha
/book-to-skill ~/books/kniha.pdf
# viac súborov naraz do jedného spoločného skillu
/book-to-skill ~/papers/paper1.pdf ~/notes/export.txt vyskumny-skill
# celý priečinok
/book-to-skill ~/workspace/dokumenty/ znalostna-baza
# glob pattern
/book-to-skill "~/books/*.epub" moja-kniznica
# doplnenie nového materiálu do existujúceho skillu (nezačína od nuly)
/book-to-skill ~/clanky/novy-clanok.pdf ~/.claude/skills/znalostna-baza
Hotový skill sa používa presne ako ktorýkoľvek iný:
/nazov-knihy # hlavné mentálne modely
/nazov-knihy replikacia # nájde a vysvetlí konkrétnu tému
/nazov-knihy ch05 # rovno na 5. kapitolu
/nazov-knihy "aké kapitoly mám?"
Pri PDF, ktoré je len naskenovaná stránka (obrázok, nie text), extrakcia hneď na začiatku zastaví a povie ti to, namiesto toho aby prešla celú 400-stranovú knihu a vrátila prázdny skill. Text v takom PDF proste neexistuje, treba ho najprv prehnať cez OCR (ocrmypdf vstup.pdf vystup.pdf) a až potom pustiť /book-to-skill na výstup. Rovnako platí, že text zapečený v obrázkoch a grafoch sa nevytiahne z hocijakého formátu, to je fyzikálna hranica extrakcie textu, nie chyba nástroja.
Funguje to aj na interné dokumenty, brand booky, research papers a vlastné poznámky, nielen na knihy v pravom zmysle slova.