book-to-skill教程：技术书PDF一键转AI技能库 Claude Code随问随答

book-to-skill：把任意书籍和文档变成 AI 技能库

book-to-skill 是一个开源工具，能把技术书籍、文档文件夹或资料集合，转换成统一的 Agent Skill——之后在 Claude Code、GitHub Copilot CLI 等环境里随时学习、查阅并在工作中使用。名字里带 book，但内部文档、入职手册、论文笔记这些反复要查的资料同样能放进去。

为什么值得用

• 支持 PDF / EPUB / DOCX / Markdown / HTML / RTF / MOBI 等主流格式，技术书建议用 Docling 提取，保留代码块和表格；
• 生成的 skill 按章节拆分成小文件，Agent 问到什么才加载什么，据官方实测比整书丢进上下文省 24–51 倍 token；
• 兼容 Claude Code、GitHub Copilot CLI、Amp、Hermes Agent、OpenClaw，所有宿主读同一份 SKILL.md 标准格式；
• 不止书籍——内部文档、运行手册、品牌手册、论文笔记簇都能转，整个 docs/ 文件夹可以一次折成一个技能库；
• 本地处理不上传文件，扫描版 PDF 会提前检测并提示先 OCR，不会闷头跑完一本书生成空技能。

它是怎么工作的

它的结构分两层：一个确定性的 Python 提取器负责把文档变成干净文本，再由一个 spec 驱动的生成器按 SKILL.md 规范产出结构化技能。它提取的是框架、决策规则和反模式，不是摘要，也不复制原文段落。

转换完成后会得到五件套：核心的 SKILL.md（约 4000 token，心智模型加章节索引）、每章一个的章节文件、术语表、模式汇总和速查表。之后只要输入 /你的技能名 加问题，Agent 就会去读对应章节，基于真实内容回答，不靠记忆编。

上手与安装

安装只要一条命令：npx skills add virgiliojr94/book-to-skill。转换时输入 /book-to-skill 加文件路径或 glob 即可，比如指向你本地的一本 PDF 或整个 docs 文件夹。

它支持分析预览、增量更新和折叠合并：新资料进来时可以先看分析结果再决定生成，已有的技能追加新文档即可合并，不用每次全量重来。

同类收藏推荐

• TVAPP：GitHub 开源电视影视盒子，一个应用看全网电视直播与影视资源
• GetZlib：Z-Library 镜像导航站，电子书资源一站找全

👉 前往 GitHub 查看 book-to-skill 完整文档

使用提示：这类 GitHub 项目直接访问仓库获取最新版本即可，本地运行需要 Python 环境，缺少依赖时工具会给出精确的安装命令。用它转换受版权保护的书籍时，生成的技能建议保持私有，不要公开分发。