book-to-skill: любая книга становится навыком ИИ-агента
Инструмент book-to-skill конвертирует PDF, EPUB и другие документы в Agent Skills для Claude Code, GitHub Copilot CLI и Amp — с экономией токенов до 51×.
Книга как навык: новый подход к работе с техническими материалами
Открытый проект book-to-skill решает старую проблему каждого разработчика: вы купили отличную техническую книгу, прочитали её один раз — и через три месяца уже не помните, что было в седьмой главе. Инструмент превращает технические книги и документы в переиспользуемые AI-навыки (agent skills), извлекая содержимое из PDF и EPUB и организуя материал так, чтобы ИИ-агент мог обращаться к нужным разделам по запросу.
Проект уже набрал более 5700 звёзд на GitHub и работает с любым хостом, поддерживающим открытый стандарт Agent Skills — GitHub Copilot CLI, Amp и Claude Code читают один и тот же формат SKILL.md.
Как это работает
Процесс предельно прост: указываете инструменту путь к файлу, папке или glob-паттерну — он дистиллирует книгу в структурированный навык, а агент загружает нужные разделы по запросу.
graph TD
A["📄 PDF / EPUB / DOCX / TXT..."] --> B["Step 1.5: тип книги?"]
B -->|"Техническая"| C["Docling — таблицы + код"]
B -->|"Текстовая"| D["pdftotext → pypdf → pdfminer"]
C --> E["scripts/extract.py"]
D --> E
E --> F["Claude анализирует структуру"]
F --> G["SKILL.md + chapters/ + glossary.md + patterns.md + cheatsheet.md"]
G --> H["~/.claude/skills/ или ~/.copilot/skills/"]
Запуск /book-to-skill your-book.pdf создаёт полноценный навык в директории агента: ~/.copilot/skills/<slug>/ для Copilot CLI, ~/.agents/skills/<slug>/ для Amp, ~/.claude/skills/<slug>/ для Claude Code. Файлы глав загружаются по требованию — они не расходуют бюджет токенов, пока вы не спросите о конкретной теме.
Структура генерируемого навыка
| Файл | Содержимое | Размер |
|---|---|---|
SKILL.md | Ключевые концепции + индекс глав | ~4 000 токенов |
chapters/ch01-*.md | По одному файлу на главу (загружаются по запросу) | ~1 000 токенов каждый |
glossary.md | Все термины с ссылками на главы | ~1 500 токенов |
patterns.md | Техники, алгоритмы, паттерны проектирования | ~2 000 токенов |
cheatsheet.md | Таблицы решений и быстрые правила | ~1 000 токенов |
Экономия токенов — до 51×
Инструмент тратит в 24–51 раз меньше токенов, чем если просто «залить» книгу в контекст для ответа на один вопрос.
Вместо создания резюме инструмент извлекает структуру: фреймворки, принципы, техники и антипаттерны. Агент не галлюцинирует — вы просто пишете /your-book-slug replication, и агент читает нужную главу и отвечает из реального содержимого.
Реальные замеры стоимости конвертации на Claude Sonnet 4.5 ($3/$15 за MTok):
| Книга | Формат | Страниц | Токенов | ~Стоимость |
|---|---|---|---|---|
| Think Python 2 | 244 | 119K | $0.88 | |
| Working Backwards | 371 | 175K | $0.96 | |
| Pro Git | 501 | 229K | $1.23 |
Поддерживаемые форматы
Инструмент конвертирует книги и документы форматов PDF, EPUB, DOCX, HTML, Markdown, обычный текст, RTF, MOBI/AZW с поддержкой Calibre.
Для PDF инструмент спрашивает тип книги и выбирает экстрактор автоматически:
| Тип книги | Инструмент | Скорость |
|---|---|---|
| Текстовая (проза) | pdftotext (poppler) | ⚡ мгновенно |
| Текстовая (запасной) | pypdf / pdfminer.six | ⚡ мгновенно |
| Техническая (код, таблицы) | Docling | ~1.5с/стр |
python3 scripts/extract.py --check — команда покажет, какие экстракторы установлены для каждого формата, и точную команду для установки недостающих.Не только книги
Название говорит «книга», но на входе может быть любая структурированная проза. Та же самая система извлечения работает с внутренней документацией — architecture decision records, runbooks, onбординг-гайдами. Также подойдут:
- Бренд-гайды и дизайн-системы — голос бренда, принципы компонентов
- Кластеры исследований — стопка статей плюс ваши заметки, объединённые в единый навык
- Спецификации и стандарты — RFC, API-контракты, compliance-документы
После установки навыка из книги «Designing Data-Intensive Applications»:
/designing-data-intensive-apps replication # объяснить тему репликации
/designing-data-intensive-apps ch05 # открыть главу 5
/designing-data-intensive-apps "что за главы у тебя есть?"
Установка
# Установка как agent skill (даёт команду /book-to-skill в Claude Code, Copilot CLI, Amp)
git clone https://github.com/virgiliojr94/book-to-skill.git ~/.claude/skills/book-to-skill
# Затем в сессии агента:
/book-to-skill /path/to/book.pdf [skill-name]
Либо через pip (только CLI-экстрактор):
pip install "book-to-skill[pdf,epub,docx]"
book-to-skill /path/to/book.pdf --mode text
Проект распространяется бесплатно под лицензией MIT.
Контекст: стандарт Agent Skills в 2026 году
Формат SKILL.md работает во всех крупных AI-агентах, принявших открытый стандарт Agent Skills, включая Claude Code, OpenAI Codex CLI, Cursor, Gemini CLI и GitHub Copilot. Сдвиг, происходящий в 2026 году, очевиден: мы переходим от разовых промптов к постоянным, компонуемым поведениям агентов — и навыки (skills) именно тот путь, которым это достигается.
book-to-skill — это практичный ответ на вопрос, как сохранить и переиспользовать знания из технических книг в эпоху, когда ИИ-агенты стали полноценными рабочими инструментами.