book-to-skill
English ·
Русский
> **Актуальность перевода.** Источник истины — [английский README](README.md). Этот перевод может отставать от `master`.
> Синхронизирован с EN на коммите [`903d102`](https://github.com/virgiliojr94/book-to-skill/commit/903d102fe8f67ea0fe3db7bea85eec7d8b505967) (2026-08-14).
> Чтобы увидеть drift: `git log 903d102..master -- README.md`
Превратите любую техническую книгу, папку документов или набор источников в единый agent skill — чтобы изучать, ссылаться и использовать в GitHub Copilot CLI, Amp или Claude Code.
Зачем ·
Что получается ·
Не только книги ·
How it works ·
Usage ·
Install ·
FAQ ·
Performance ·
Architecture ·
Changelog
В 24×–51× меньше токенов , чем «залить книгу в контекст», чтобы ответить на один вопрос — на реальных книгах (как меряли ).
**Как это работает, в 3 шага:**
1. **Укажите** файл, папку или glob — `/book-to-skill ./my-book.pdf`
2. **Дистилляция** в skill — frameworks, decision rules, anti-patterns, per-chapter files. Структура, не «краткий пересказ».
3. **Агент грузит on demand** — `/my-book replication` читает нужную главу и отвечает по реальному содержимому, без галлюцинаций.
---
## 🤔 Зачем
/`, `~/.agents/skills//`, `~/.claude/skills//`):
| File | Purpose | Size |
|------|---------|------|
| `SKILL.md` | Core mental models + chapter index | ~4,000 tokens |
| `chapters/ch01-*.md` … | Одна глава on-demand | ~1,000 tokens each |
| `glossary.md` | Ключевые термины + refs | ~1,500 tokens |
| `patterns.md` | Techniques, algorithms, patterns | ~2,000 tokens |
| `cheatsheet.md` | Decision tables / quick rules | ~1,000 tokens |
**Chapter files on-demand** — не жрут skill budget, пока не спросите тему.
---
## 🏢 Не только книги
Имя «book», вход — любой structured prose:
- **Internal docs** — ADR, runbooks, onboarding
- **Brand & design systems** — voice, tone, principles
- **Research clusters** — papers + notes (см. update/fold-in)
- **Specs & standards** — RFCs, API contracts, compliance
Если документ часто переоткрываете — кандидат.
---
## 🧾 The Discovery Loop Tax
PDF-агент не просто читает — *навигирует*: ToC, backtrack, re-process каждый ход. book-to-skill платит structuring cost **один раз** при конверсии — **24×–51×** меньше токенов.
📊 **Методика → [docs/performance.md](docs/performance.md#the-discovery-loop-tax)**
---
## ⚙️ How it works
Две половины: deterministic Python **extractor** и spec-driven **generator** (агент следует `SKILL.md`). On-demand chapters держат loaded skill маленьким.
🔧 **Полный walkthrough → [docs/how-it-works.md](docs/how-it-works.md)**
---
## 🚀 Usage
`/book-to-skill [skill-name]` — plus analyze-only, generate-from-analysis, and update/fold-in modes. После конверсии converter может опубликовать skill на GitHub (по умолчанию private), чтобы любой host ставил его через `npx skills add`.
▶️ **Все режимы и примеры → [docs/usage.md](docs/usage.md)**
💬 **На практике → [use cases](https://github.com/virgiliojr94/book-to-skill-use-cases)** — DevEx-книга превратилась в survey 300+ инженеров; scanned PDF, который «завис», стал [#130](https://github.com/virgiliojr94/book-to-skill/pull/130). Добавьте свой кейс: account в вашем Gist, index — one-line PR.
---
## 📥 Install
```bash
# One command, any host:
npx skills add virgiliojr94/book-to-skill
# Or manually:
git clone https://github.com/virgiliojr94/book-to-skill.git ~/.claude/skills/book-to-skill
# (Copilot: ~/.copilot/skills/ · Amp: ~/.agents/skills/)
```
📥 **Все хосты → [docs/install.md](docs/install.md)**
---
## ❓ FAQ
❓ **Ответы → [docs/faq.md](docs/faq.md)**
---
🔧 Requirements
Extractor пробует tools по порядку. Check: `python3 scripts/extract.py --check`
**PDF — по типу книги:**
| Book type | Tool | Install | Speed |
|-----------|------|---------|-------|
| Text-heavy | `pdftotext` (poppler) | `sudo apt install poppler-utils` | ⚡ |
| Text-heavy fallback | `pypdf` | `pip3 install pypdf` | ⚡ |
| Text-heavy fallback | `pdfminer.six` | `pip3 install pdfminer.six` | ⚡ |
| **Technical** | **`docling`** | `pip3 install docling` | ~1.5s/page |
> **Scanned PDFs** — сначала OCR (`ocrmypdf`), иначе пустой skill.
**EPUB / DOCX / HTML / RTF / MOBI** — см. English README tables; зависимости через pip / Calibre.
📁 Repository structure
См. English README — дерево `SKILL.md`, `scripts/extractor/`, `tools/`, `docs/` без изменений.
---
## ⚖️ Copyright & fair use
book-to-skill **не** содержит книг. Converter для файлов, которые вы уже имеете право читать.
- Processing **local**
- Своя копия / company docs
- Output = structured notes, не reproduction
- **Не** redistributе skills чужих copyrighted books
---
## 💖 Sponsors
**[Become a sponsor →](https://github.com/sponsors/virgiliojr94)** · [BACKERS.md](BACKERS.md)
## License
MIT — на converter в этом репо, **не** на книги/документы, которые вы обрабатываете.
## Star History
---
Russian translation synced to English README at commit 903d102 · English remains canonical · Maintainer: @MonteNegroX
Купили отличную книгу. Прочитали. Через три месяца глава 7 будто не существовала.
Обычные обходы не помогают:
- 📄 «Поищу в PDF» → список страниц, не ответы
- 🧠 «Спрошу агента про книгу» → галлюцинации или «нет содержимого»
- 📝 «Заметки по ходу» → 200-строчный файл, который больше не открываете
**book-to-skill превращает книгу в structured skill, который агент подгружает по запросу.**
После установки: `/your-book-slug replication` — агент читает нужную главу и отвечает из текста. Без галлюцинаций и копания в PDF.
Работает с хостами open [Agent Skills](https://github.com/agentskills/agentskills) — GitHub Copilot CLI, Amp, Claude Code (общий формат `SKILL.md`).
---
## 📦 Что получается
`/book-to-skill your-book.pdf` (или folder/glob) создаёт skill в директории skills агента (`~/.copilot/skills/