Code on a screen with a dark theme

Book-to-Skill:把一本书炼成 AI Agent 能真正调用的 Skill

介绍开源工具 Book-to-Skill:将 PDF/EPUB/DOCX 等书籍与文档提炼为结构化 Agent Skill(框架、章节、术语、方法、速查表),支持 Claude Code、Copilot CLI 等按需加载,显著降低 Token 消耗,把「AI 读过」升级为「AI 会用」。

很多人让 AI「读过」一本书的方式,是把整本 PDF 丢进上下文。
结果往往是:Token 烧得快,关键框架记不牢,问到细节还要对着原书翻。

Book-to-Skill 做的是另一件事:把书(或文档)提炼成结构化的 Agent Skill,而不是一份超长摘要。

项目地址:https://github.com/virgiliojr94/book-to-skill

它具体做什么?

支持 PDF、EPUB、DOCX、Markdown 等格式。跑完之后会生成标准 SKILL.md 及相关文件,大致包括:

  • 核心心智模型与框架
  • 按章节拆分的内容(按需加载)
  • 术语表
  • 方法 / 模式 / 反模式
  • 速查表与决策规则

之后可以放进 Claude Code、GitHub Copilot CLI、Amp 等支持 Agent Skills 标准的工具;稍作适配也能给 Codex 一类环境用。

官方口径是:不必每次把整本书塞进上下文,问到哪加载哪一章,实测可减少约 24×–51× Token。

为什么比「整本塞进上下文」更有用?

  1. 结构,不是读后感
    重点保留作者的命名框架、决策规则和可执行方法,而不是泛泛总结。
  2. 按需加载
    对话时只拉取相关章节或条目,成本和噪音都更可控。
  3. 可复用资产
    生成的 Skill 可以反复用,相当于把「读过这本书」升级成「工作流里随时能调用这本书」。
  4. 不限于书
    公司文档、论文、技术规范、品牌手册、内训材料,都可以按同样思路处理。

适合什么场景?

  • 技术书、方法论类书籍想长期内化进 Agent
  • 团队有一套规范文档,希望 AI 按同一套术语和流程回答
  • 研究多篇论文 / 资料,想统一成可检索的知识技能
  • 已经在用 Claude Code、Copilot CLI 等,希望扩展垂直领域能力

使用时的现实提醒

  • 提炼质量取决于原书结构是否清晰。术语混乱、意图模糊的材料,提取结果可能不稳定,需要人工抽查和微调。
  • 涉及版权内容时,请遵守相应授权,仅用于合法范围内的个人或团队学习与内部使用。
  • 生成后建议先用几个真实问题压测,确认框架、章节索引和术语是否准确。
  • 项目仍在迭代,安装与命令以仓库最新文档为准。

小结

Book-to-Skill 的价值,不在于又多了一个「AI 读书」按钮,而在于把书籍和文档,从一次性上下文消耗,变成可版本化、可按需调用的 Agent 能力。

「让 AI 读过这本书」和「让 AI 真正会用这本书」,中间差的就是这种结构化封装。

如果你已经在用 Agent 写代码、做研究或跑业务流程,不妨拿一本自己常翻的技术书或一份内部规范试一次,看看 Token 和回答质量的变化。