book-to-skill Skill：把技术书秒变可对话的AI技能，两天破千星

把一本技术书买回来，你通常读一遍就忘。三个月后连第 7 章讲什么都想不起来。book-to-skill 就是来解决这个问题的：它把任意技术书籍或文档的 PDF 直接转换成一个结构化的 Claude Code Skill，让 AI 在你需要的时候按需加载对应章节来回答问题，而不是把整本书塞进上下文导致 token 爆炸或幻觉。这个工具 8 月 13 日才上线 GitHub，两天内就冲到了 1,000+ Star，是近期 Skills 生态里增长最快的工具类 Skill 之一。

功能与原则

book-to-skill 的核心功能是把 PDF/EPUB/DOCX 等技术文档转换为一个符合开放 Agent Skills 标准的技能包。它的设计原则有三条：结构化而非摘要——输出的是框架、决策规则、反模式，不是缩句；按需加载——章节文件独立存储，只有被问到时才加载，不消耗 skill budget；本地处理——文件从不离开本机，隐私安全。

认可度

截至 2026-08-15，book-to-skill 的 GitHub 数据：

• Star：1,094（上线仅 2 天）
• Forks：138
• 最后更新：2026-08-15
• 编程语言：Python
• 衍生自原项目 virgiliojr94/book-to-skill，由 Leutenegger 重写核心引擎

链接

GitHub：https://github.com/Leutenegger/book-to-skill

原作者

Leutenegger（GitHub username: Leutenegger），独立开发者，专注于 AI 辅助学习与知识管理工具链。其重写的 book-to-skill 在原项目基础上将 extractor 改为确定性 Python 管道，generator 改为 spec 驱动生成器，结构更清晰。

介绍

技术书籍的价值在于反复查阅，但大多数人的实际情况是：买来读一遍，三个月后形同陌路。传统解法有三个明显缺陷：搜 PDF 只返回页面列表而非答案；直接问 AI 容易得到幻觉回复；自己做笔记最后变成一个永远不会再打开的 200 行文档。

book-to-skill 从另一个角度切入——不是让 AI 去”记住”整本书，而是把书转换成 AI 可以按需查询的技能包。运行 book-to-skill ./my-book.pdf，工具会：先提取书籍文本内容并做结构化分析；然后生成符合 Agent Skills 规范的技能文件（SKILL.md 核心心智模型 + 每章独立 .md + 术语表 + 模式库 + 速查表）；最后把技能安装到本地的 skills 目录。之后在 Claude Code 里输入 /my-book replication，AI 会自动读取相关章节并基于真实内容回答，不 hallucinate，不乱猜。

支持任意支持开放 Agent Skills 标准的平台：GitHub Copilot CLI、Amp、Claude Code 均读取同一套 SKILL.md 格式。

特点

• 超低 token 消耗：官方测试数据，相比直接把整本书塞进上下文回答单个问题，book-to-skill 生成的技能 token 用量减少 24×–51×
• 多格式支持：PDF（pdftotext / pypdf / pdfminer / docling）、EPUB、DOCX、HTML、RTF、MOBI、AZW3，扫描 PDF 需先 OCR
• 按需章节加载：chapters/ 目录下的每章 .md 独立存储，问到什么才加载什么，不浪费 context window
• 安装零门槛：一行 pip install -e . + book-to-skill install 自动把技能拷贝到各平台的 skills 目录
• 本地隐私：所有处理在本地完成，文件不外传，适合处理内部文档或自有书籍

使用方法

安装（推荐方式，自动检测平台）：

pip install -e .
book-to-skill install

这会把技能安装到 ~/.claude/skills/book-to-skill、~/.agents/skills/book-to-skill、~/.copilot/skills/book-to-skill（按平台自动选择）。

转换一本书：

book-to-skill path/to/book.pdf
book-to-skill "path/to/docs/*.epub" my-skill-slug
book-to-skill --check   # 检查各格式依赖工具是否就绪

在 Claude Code 中使用：

/my-book-slug replication
# AI 自动加载对应章节，回答来自真实书籍内容

其他命令：

book-to-skill list       # 列出已安装技能
book-to-skill readme     # 输出某技能的 README
book-to-skill ui         # 启动图形界面

使用场景与人群

适用场景：

• 深度技术书籍（算法、系统设计、架构）的持续学习和随时查阅
• 内部文档（ADR、runbook、入职指南）转化为可查询技能
• 品牌/设计系统的规范文档封装为 AI 可调用的参考技能
• 科研论文集 + 笔记的结构化，构建个人知识库
• RFC、API 契约、合规文档等长期维护型资料的快速查询

目标用户：

• 工程师 / 开发者：把《设计模式》《重构》这类常翻常忘的书变成可查询的 AI 技能
• 研究者：把论文 PDF 转成可对话的研究笔记
• 技术写作者：把内部文档转化为结构化知识库

输入与输出案例

案例一：转换《Design Patterns》

book-to-skill ./design-patterns-gang-of-four.pdf gof-patterns

生成技能文件结构：

在 Claude Code 中查询：

/gof-patterns replication
> 解释一下 Strategy 模式和 State 模式的本质区别

AI 自动加载 Strategy/State 相关章节，基于真实内容回答，无幻觉。

案例二：转换 EPUB 技术文档

book-to-skill "~/Library/Books/*.epub" my-library

所有 EPUB 批量转换为一个技能包，后续 /my-library 可在整个图书馆范围内检索和对话。

GitHub: https://github.com/Leutenegger/book-to-skill