Skill Book-To-Skill 把技术书一键转成AI编程技能

你买过一本很棒的技术书，读一遍，三个月后连第 7 章存在都记不清。常见的 workaround 都不灵：搜 PDF 出来一堆页码不是答案；把书丢给 agent 它要么幻觉要么说没有内容；自己做笔记最终又是一份从不打开的万字文档。
真正的需求是：让书成为工作流的一部分——需要时 agent 自己读对的那一章、从真实内容作答，而不是把整本书塞进上下文烧 token。book-to-skill 做的就是这件事：把书变成结构化 skill，按需加载。

项目基本信息

一、项目介绍

virgiliojr94/book-to-skill 是一个 MIT 协议的开源工具，把任意技术书、文档文件夹或资料集合，蒸馏成一个统一的 Agent Skill。它用 Python 确定性提取器把文档转成干净文本与元数据，再用 spec 驱动的生成器产出 SKILL.md、分章文件、术语表、模式库与速查表。生成的 skill 落在跨 agent 共享目录（~/.agents/skills），Claude Code、Codex、Copilot CLI、OpenCode、OpenClaw 等只要支持开放 Agent Skills 标准都能直接读取。官方称相比把整本书丢进上下文，回答一个问题能省 24×–51× token。

二、核心优势

1. 按需加载：分章文件平时不计入 skill 预算，问到相关主题才读取，上下文始终很小。
2. 结构化而非摘要：产出的是框架、决策规则、反模式与分章索引，是结构不是总结。
3. 跨 agent：一份 skill 同时被 Claude Code、Codex、Copilot、OpenCode 等原生发现。
4. 不止书：内部文档、品牌规范、论文集群、RFC/API 契约都能折成 skill。
5. 可发布：转换后能把 skill 推到 GitHub（默认私有），其它主机用 npx skills add 安装。

三、适用场景

• 把团队内部架构决策记录/运维手册折成随时可问的 skill。
• 把品牌与语气规范变成团队查询的 skill，而非翻阅 60 页 PDF。
• 把一堆论文加自己的笔记合并成单一 skill，新资料到了再 fold-in。
• 把经常重读却记不住的规范/RFC 变成 agent 可即时调用的知识。

四、安装教程

任意主机一键安装（走跨 agent skills CLI）：

npx skills add virgiliojr94/book-to-skill

或手动克隆到技能目录：

git clone https://github.com/virgiliojr94/book-to-skill.git ~/.claude/skills/book-to-skill
# Copilot CLI: ~/.copilot/skills/ · 跨 agent: ~/.agents/skills/

常见报错：npx 找不到命令先确认 Node.js 已装；Claude Code 下若 symlink 未被识别，运行报告会提示，可改用手动克隆。

五、使用示例

把一个 PDF 转换成 skill：

/book-to-skill ./my-book.pdf
# 或指向文件夹/通配符/文件列表

转换完成后，agent 会把它装到 ~/.agents/skills//，包含 SKILL.md 与 chapters/ch01-*.md 等分章文件。真实体验：你输入 /your-book-slug replication，agent 读对的那一章、基于真实内容作答，不再幻觉、不再翻 PDF。也支持纯分析、从分析生成、以及更新/fold-in 模式。

六、常见问题

Q：它和直接把书丢给 agent 有什么区别？
A：book-to-skill 在转换时一次性付出结构化成本，之后查询开销只与答案成正比，官方测得省 24×–51× token。
Q：支持哪些 agent？
A：任何支持开放 Agent Skills 标准的宿主：Claude Code、Codex、Copilot CLI、Amp、OpenCode、OpenClaw、Hermes Agent 等。
Q：协议能商用吗？
A：采用 MIT License，可自由商用与修改，需保留版权与许可声明。

七、总结

book-to-skill 把“反复翻书/翻 PDF”变成“一次转换、长期复用”的结构化 skill，让技术书真正成为 agent 工作流的一部分。对重度依赖文档与规范的开发者与团队，它是显著降低 token 消耗的实用工具；MIT 协议让二次分发没有门槛。