为什么需要
出海开发者经常买技术书学海外平台（Stripe、AWS、Twilio、Shopify）的最佳实践，但读完就忘——三个月后想查细节只能 Ctrl+F 翻 PDF，或者让 Agent 直接读全文，但 Agent 一看就是 50 万 token，浪费钱还可能幻觉。
Book-to-Skill 把书变成 Claude Code / Copilot CLI / Amp 直接加载的 Skill 目录——核心是 SKILL.md（4000 tokens 的思维框架 + 章节索引）、按需加载的 chapter 文件、glossary、patterns、cheatsheet。问 /my-book replication 时，Agent 只读相关章节（~1000 tokens）就能给出原文级别的答案，不幻觉。
怎么用
三步搞定：
bash
pip install -e .
book-to-skill install # 安装到 ~/.claude/skills/
book-to-skill path/to/book.pdf
输出是一个完整 Skill 目录：
| 文件 | 用途 | Token 数 |
|---|---|---|
SKILL.md | 核心思维模型 + 章节索引 | ~4,000 |
chapters/chXX-*.md | 每章一个文件，按需加载 | ~1,000/章 |
glossary.md | 关键术语带章节引用 | ~1,500 |
patterns.md | 技术、设计模式 | ~2,000 |
cheatsheet.md | 决策表 + 速查 | ~1,000 |
支持 PDF、EPUB、DOCX、HTML、Markdown、RTF、MOBI 等格式。技术书（有代码、表格）自动用 docling 解析，纯文本用 pdftotext。
使用案例
独立开发者买了《Designing Data-Intensive Applications》想长期参考——用 Book-to-Skill 转一遍，每次问 Claude Code「DDIA 第 7 章事务隔离级别的权衡」，Agent 直接读 ch07.md 给出原文级别的答案，不用重读 600 页 PDF。
另一个场景：海外团队的 onboarding 文档（旧员工 ADRs、runbook、规范）转成 Skill，新人问任何历史决策都能拿到结构化答案，不用问老人。
注意事项
- MIT 协议，完全免费
- 支持 PDF/EPUB/DOCX/HTML/Markdown/RTF/MOBI 7 种格式
- 需要版权合法——只能用你已拥有的书或文档，工具不上传文件
- 兼容 Agent Skills 标准（Claude Code、Copilot CLI、Amp 都支持）
- 技术书建议装
pip install book-to-skill[all]启用 docling 解析 - 扫描版 PDF 需要先 OCR（
ocrmypdf）