用 book-to-skill 把技术书变成智能体技能

一本好书你只读了一遍，三个月后已经想不起第 7 章的存在。book-to-skill 是一个 31k 星的转换器，它把书变成结构化的技能供智能体按需加载——让提问取代再次翻 PDF。

为什么这个 Skill 重要

对文件、目录或 glob 运行 /book-to-skill，它会在 ~/.agents/skills/<slug>/ 下构建一个技能：一份带核心心智模型和章节索引的 SKILL.md（约 4000 token）、每章一个 Markdown 文件（各约 1000 token），外加词汇表、模式集和速查表。章节文件只在你问到那个主题时才加载，常驻的 token 开销始终很小。

底层分两半：确定性的 Python 提取器把文档变成干净文本，规格驱动的生成器——你的智能体照着 SKILL.md 执行——把文本重构成技能。README 报告每次提问比把整本书塞进上下文节省 24 到 51 倍 token（在真实书籍上测得）；这是项目自己的基准，当作方向性参考，别当保证。

安装

一条命令的路线适用于任何读取 Agent Skills 标准的宿主：

npx skills add virgiliojr94/book-to-skill

或者手动克隆进技能目录——Claude Code 用 ~/.claude/skills/book-to-skill，Copilot CLI 用 ~/.copilot/skills/，跨代理通用目录用 ~/.agents/skills/。

实战流程：让一本书变得可提问

转换你自己手里的书，可以传一个可选的技能名：

/book-to-skill ./designing-data-intensive-applications.pdf ddia

提取开始前，技能会问这本书偏技术还是偏文字，并据此选工具：代码、表格、公式用 docling（约每页 1.5 秒），纯文字用 pdftotext。扫描版 PDF 没有文本层可提取——提取器会检查前几页然后停下来告诉你；先跑 ocrmypdf，再转换。

生成之后，只问其中一章，智能体就只读那一个文件：

/ddia replication

实战流程：把团队文档折成一个技能

名字虽然叫书，但任何结构化散文都行。把它指向你的 docs/ 目录——架构决策记录、运维手册、入职指南——同样的提取会产出一个团队写代码时随手可查的技能。新资料到位后，用 update/fold-in 模式合并进现有技能，不用从头再来。

技巧

• 先用 python3 scripts/extract.py --check 检查提取器——它会按格式列出已装的工具，并给出缺什么、怎么装的准确命令。
• 覆盖的格式：PDF、EPUB、DOCX、HTML、RTF，其中纯文本和 Markdown 无需额外依赖；MOBI 和 AZW 走 Calibre 的 ebook-convert。
• 转换完成后，转换器可以把技能发布到 GitHub（默认私有），让其他宿主用 npx skills add 安装。
• 版权姿态在 README 里写得很明确：处理在本地完成，产出是综合笔记而不是原文段落，受版权保护书籍生成的技能应保持私有。

什么时候不该用它

查个名词解释不值得做一次转换——直接对话更快。你拿不回逐字原文：技能明确从不复制原始段落，产出的是结构化笔记，要引用就得回到书本身。还有，受版权保护书籍生成的技能不要外发——README 自己的指引就是保持私有。

查看排行榜了解更多 skill。