30. augusta 2026

Z knihy Claude skill: book-to-skill krok za krokom

Ako premeníš PDF alebo epub knihy na skill, z ktorého Claude reálne čerpá, ako to funguje pod kapotou a prečo to šetrí desiatky-násobne viac tokenov než hodiť knihu do chatu.

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:

  1. 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 pdftotext pre bežný text (pár sekúnd na celú knihu), alebo Docling pre technické knihy, ktorý navyše zachytí tabuľky a kód ako poriadny markdown (pomalšie, ale nič sa nestratí).
  2. Rozpoznanie štruktúry. Claude prejde vytiahnutý text a nájde názov, autora, kapitoly a obsah.
  3. 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.
  4. 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.