你有没有这种情况:买了一本技术书,读了一遍,三个月后连第七章讲什么都想不起来了。想用的时候要么翻 PDF 搜关键词,要么问 AI 但模型不懂那本书的内容,纯靠幻觉编。
有个叫 book-to-skill 的开源工具就是专门治这毛病的——把任何技术书、文档夹、论文集合转成 Agent Skill,装进去之后 Claude Code、Copilot CLI、Amp 随时调,不幻觉、不翻 PDF、不重新读。
GitHub 上 1.5 个月拿了 5.7K Stars,v1.1.0 是 3 天前发布的。
是什么
本质是一个 Python 写的文档提取器(+ 数据工程后端)。你丢给它一个 PDF、EPUB、DOCX 或者整个文件夹,它自动提取内容,按 Agent Skills 开放标准生成一个完整的 Skill 目录:
- SKILL.md: 核心思维模型 + 章节索引,~4000 tokens
- chapters/ch01-*.md …: 每章一个文件,按需加载,~1000 tokens 每章
- glossary.md: 关键术语表,按字母排序附章节引用
- patterns.md: 所有技术、算法、设计模式整理
- cheatsheet.md: 决策表和快速参考规则
装好之后,直接在 Agent 里说 /designing-data-intensive-apps replication,Agent 就会从书中找到"数据复制"那一章给你参考。不会像没看过书一样瞎编。
项目地址:github.com/virgiliojr94/book-to-skill
不止是书
名字叫 book-to-skill,但输入范围大得多:
- 内部文档: 架构决策记录、运维手册、新员工指南 — 整个 docs/ 文件夹一键转 Skill
- 品牌 & 设计系统: 设计规范、语音指南 — 团队直接查,不用翻 60 页 PDF
- 论文集合: 一堆论文 + 你的笔记合并成一个 Skill,有新论文还能增量添加
- API 规范 / RFC: 经常翻但记不住的标准化文档
一句话:如果你反复打开某个文档的次数够多,它就该转成 Skill。
支持的格式
PDF、EPUB、DOCX、TXT、Markdown、reStructuredText、AsciiDoc、HTML、RTF、MOBI/AZW/AZW3。
每个格式有自动提取器,优先用最快的工具,没有则自动降级。不需要额外环境也能处理纯文本和 Markdown。
PDF 提取还会问你是"技术书"还是"纯文本书"——技术类用 Docling(保留表格和代码块,~1.5 秒/页),文本类用 pdftotext(瞬间)。
怎么用
# 转一本书
/book-to-skill 数据密集型应用系统设计.pdf
# 转一个文档夹
/book-to-skill ~/workspace/project-docs/ project-knowledge
# 增量添加新内容到已有 Skill
/book-to-skill ~/papers/new-paper.pdf ~/.claude/skills/project-knowledge
装完之后在 Agent 里:
/designing-data-intensive-apps # 加载核心思维模型
/designing-data-intensive-apps replication # 直接问书中内容
/designing-data-intensive-apps ch05 # 精确取某一章
Claude Code 和 Amp 重启会话后自动生效,Copilot CLI 需要跑一下 /skills reload。
跟 Hermes Agent 的 Skill 是同一标准
book-to-skill 输出的是 Agent Skills 开放标准格式。这意味着它生成的 Skill 能在 Hermes Agent、Claude Code、Copilot CLI、Amp 等任何支持该标准的 Agent 上直接用。不是封闭生态。
不是没有槽点
1. 对技术书效果最好,散文类书收益小。 一本叙事型书转成 Skill 的意义不大——你不如直接看。技术类因为需要查章节、找算法、回顾模式,才值得转。
2. 首次提取需要装一些工具。 PDF 需要 pdftotext 或 Docling,EPUB 需要 ebooklib,MOBI 需要 Calibre。好在提取器会检查环境并告诉你需要装什么。
3. 才火了 1.5 个月。 5.7K Stars 涨得很快,但项目还很新,API 和工作流还在演进。
4. 中文书支持取决于底层提取器。 Docling 和 pdftotext 对中文 PDF 支持基本 OK,但扫描版 PDF 可能需要 OCR。
一句话总结
如果你桌子上堆了一堆技术书,每次翻到某章找某个概念都要花十分钟——book-to-skill 把你买过的书变成 Agent 记忆,值回 5.7K Stars。
GitHub:github.com/virgiliojr94/book-to-skill
标签:#BookToSkill #AI技能 #ClaudeCode #CopilotCLI #AgentSkills #技术书PDF #知识管理 #开源 #SKILL.md
关注我,每期分享一个帮你省事的强大工具 🛠️