为何需要 book-to-skill

买的技术书籍，读过后很快遗忘内容。常见解决办法效果不佳，如搜索 PDF 只能得页面列表，让代理查询可能生成虚假信息或说无相关内容，做笔记后也很少再看。book-to-skill 能将书籍转化为结构化技能，供代理按需加载。安装后，输入 `/your-book-slug replication`，代理就能读取相应章节并根据实际内容作答，不生成虚假信息，无需在 PDF 中翻找，让书籍融入工作流程。它适用于所有支持开放代理技能标准的平台，GitHub Copilot CLI、Amp 和 Claude Code 都能读取相同的 SKILL.md 格式。

它能生成什么

运行 `/book-to-skill your-book.pdf`（也可是文件夹、通配符或文件列表），会在代理的技能目录中创建完整技能：`SKILL.md`（核心思维模型 + 章节索引，约 4000 个 token）、`chapters/ch01-*.md`（每章一个文件，按需加载，每个约 1000 个 token）、`glossary.md`（所有关键术语，按字母顺序排序并标注章节参考，约 1500 个 token）、`patterns.md`（所有技术、算法和设计模式，约 2000 个 token）、`cheatsheet.md`（决策表和快速参考规则，约 1000 个 token）。章节文件按需加载，询问相关主题前，不占用技能预算。

不止适用于书籍

虽名字含 "book"，但输入可以是任何结构化的散文内容。同样的提取方法适用于常重读的知识，如内部文档、品牌与设计系统、研究集合、规范与标准等。

使用方法

命令为 `/book-to-skill ... [skill-name-slug]`，支持多种文档格式。给出了将多个文件处理成统一技能、处理文件夹中支持文件、处理符合通配符模式文件、更新/合并新资料到现有技能文件夹等示例。技能创建后，可按不同方式使用。在 GitHub Copilot CLI 中，写入文件后可能需运行 `/skills reload`，新技能才会出现在 `/skills` 列表中，Claude Code 和 Amp 会在下一个会话中自动识别。

要求

提取器会按格式顺序尝试工具，未安装工具会告知需运行的命令。纯文本等无需额外依赖，可用 `python3 scripts/extract.py --check` 检查设置。针对不同格式如 PDF、EPUB 等，介绍了适用工具及安装命令。

工作原理

步骤包括提供文件等、判断书籍类型、按源文件处理、Claude 分析结构、生成每章摘要、生成词汇表等、生成主 `SKILL.md`、写入技能到指定目录。还给出了提取基准测试和实际转换情况，以及设计原则。

探索循环成本

PDF 阅读代理有导航成本，book-to-skill 在编译时一次性支付导航成本。通过测量可知其在回答问题时所需上下文 token 数量优势明显，且优势随章节大小增加而增加，可使用自己的书籍重现。同时给出注意事项。

常见问题解答

解答了能否将 PDF/EPUB 放入 Claude 项目上下文、Claude 有 1M token 上下文窗口能否直接加载整本书、是否只是 RAG、流行书籍在 Claude 训练数据中为何还要用 book-to-skill、NotebookLM 与 book-to-skill 适用场景等问题。

安装方法

有作为代理技能和作为独立 CLI 两种使用方式，分别介绍了具体操作和命令。

仓库结构

展示了 book-to-skill 仓库的具体结构。

版权与合理使用

book-to-skill 不包含书籍内容，处理过程本地进行，不上传文件。使用自己的副本，生成的技能是衍生作品，仅供个人使用，分享受版权保护作品技能可能侵权，需遵循源文档许可或条款。

赞助

book-to-skill 免费，采用 MIT 许可证，由开发者利用个人时间维护，可考虑赞助其维护工作。

许可证

MIT 许可证适用于仓库中的转换器，不适用于处理的书籍或文档。

星标历史

未提及具体星标历史内容。