book-to-skill

book-to-skill 工具简介

book-to-skill 是一款开源的 Claude Code 技能工具，能够将 PDF、EPUB、DOCX 等格式的技术书籍或文档集合转化为结构化的 AI 技能库。该工具通过深度分析提取书中的核心框架、术语与模式，生成 SKILL.md 主文件以及按章拆分的独立文件，并配备术语表和速查表。使用时，用户只需输入“/技能名 关键词”，Claude 便会按需加载对应章节，避免一次性塞入整本书而消耗大量 Token。同时，它基于原文内容精准回答，有效解决了“读完即忘”、PDF 搜索低效和 AI 幻觉等问题。

主要功能

• 多格式文档转换：支持 PDF、EPUB、DOCX、TXT、Markdown、HTML、RTF、MOBI/AZW 等常见格式，可将单本书籍或整个文档文件夹转化为 Claude Code 技能。
• 智能提取策略：自动判断书籍类型（如包含代码或表格的技术类与文本密集型），并选择对应的提取工具。例如，使用 Docling 保留 Markdown 表格和代码块，或使用 pdftotext 快速提取纯文本。
• 结构化技能生成：生成包含核心思维模型与章节索引的 SKILL.md 文件、按章拆分的独立文件，以及术语表、模式表和速查表。
• 按需加载机制：章节文件不会一次性塞入对话上下文，仅当用户询问相关主题时才加载对应章节，大幅节省 Token 消耗。
• 深度知识提取：对书籍进行一次深度分析，提取作者的命名框架、可执行原则、逐步技术、反模式及语气风格，而非简单的摘要或片段检索。
• 多源合并与增量更新：支持将多个文件、整个文件夹或 glob 匹配的文件批量合并为统一技能，也可向已有技能追加新资料。
• 精准查询调用：安装后通过“/技能名 关键词”或“/技能名 ch05”直接定位到对应章节，基于原文内容精准回答，避免 AI 幻觉。
• Token 成本可控：在完整转换前提供消耗预估，支持先选择“仅分析”模式预览结构，再决定是否生成完整技能。

使用指南

安装与转换

• 一键安装：在 Claude Code 会话中输入“Install book-to-skill: https://raw.githubusercontent.com/virgiliojr94/book-to-skill/master/SKILL.md”，或手动执行“git clone https://github.com/virgiliojr94/book-to-skill.git ~/.claude/skills/book-to-skill”。
• 转换单本书籍：在 Claude Code 中输入“/book-to-skill ~/path/to/your-book.pdf”，支持 PDF、EPUB、DOCX 等多种格式。
• 转换多个文件：输入“/book-to-skill ~/papers/paper1.pdf ~/notes/export.txt unified-research”，将多份资料合并为一个统一技能。
• 转换整个文件夹：输入“/book-to-skill ~/workspace/project-docs/ project-knowledge”，批量处理文件夹内所有支持格式的文档。
• Glob 批量匹配：输入“/book-to-skill "~/books/*.epub" my-library”，按通配符规则批量转换书籍。
• 增量更新技能：输入“/book-to-skill ~/articles/new-paper.pdf ~/.claude/skills/project-knowledge”，向已有技能追加新资料。
• 选择提取模式：处理 PDF 时根据提示选择“技术书”（代码或表格密集，使用 Docling）或“文本密集型”（使用 pdftotext），以平衡精度与速度。

知识调用与查询

• 按需调用知识：转换完成后，通过“/技能名 关键词”（如“/designing-data-intensive-apps replication”）精准定位并解释特定主题。
• 深入指定章节：通过“/技能名 ch05”直接加载并深入第 5 章内容，仅该章节进入上下文。
• 查看章节索引：通过“/技能名 "what chapters do you have?"”查询该技能包含的所有章节和框架。

核心优势

• 高保真框架提取：严格保留作者原始命名与精确表述（如提取“The 5 Whys”而非泛化为“多问几个为什么”），确保知识体系的准确性。
• 按需加载省 Token：章节文件独立存储，仅当询问相关主题时才加载对应章节，避免一次性塞入整本书消耗大量上下文。
• 零幻觉精准回答：完全基于用户提供的实际文本内容回答，不依赖训练数据，杜绝冷门书籍或具体章节的幻觉问题。
• 深度结构化而非片段检索：在“编译时”深度分析提取命名框架、反模式、可执行原则，而非查询时简单向量检索文本片段。
• 无缝融入工作流：安装后通过“/技能名 关键词”直接调用，将书籍知识转化为编码或写作过程中的实时参考工具。
• 智能格式适配：自动识别技术书与文本书，自动选择 Docling 或 pdftotext 等最优提取工具链。

同类竞品对比

book-to-skill 与 Google NotebookLM 及 ChatPDF 在多个维度上存在差异：

• 核心定位：book-to-skill 将书籍编译为 Claude Code 结构化 Skill，融入编码或写作工作流；Google NotebookLM 是 AI 知识探索平台，作为研究助理与思考伙伴；ChatPDF 则是 PDF AI 对话工具，用于快速提取信息。
• 技术路线：book-to-skill 采用编译时深度分析，提取命名框架、反模式与可执行原则；NotebookLM 采用 RAG 向量检索加 Gemini 合成；ChatPDF 采用语义索引加查询时片段检索。
• 知识组织：book-to-skill 生成 SKILL.md、分章文件、术语表、模式表和速查表；NotebookLM 采用笔记本与源两级管理，支持 50 至 300 个源；ChatPDF 为单文档或会话级集合，无结构化拆分。
• 上下文策略：book-to-skill 按需加载，仅相关章节进入对话；NotebookLM 在查询时注入检索到的相关片段；ChatPDF 在查询时注入匹配到的文本段落。
• 框架保真度：book-to-skill 保真度高，保留作者原始命名与精确表述；NotebookLM 保真度中等，基于检索片段合成，可能泛化表述；ChatPDF 保真度低，依赖检索片段，无结构化提取。
• 跨书检索：book-to-skill 较弱，适合单书或关联文档组深入；NotebookLM 较强，原生支持 50 个以上文档交叉分析；ChatPDF 较弱，仅支持单文档或少量文件对话。
• 衍生内容：book-to-skill 无衍生内容，专注可调用知识框架；NotebookLM 衍生能力强，支持播客、幻灯片、测验、思维导图等；ChatPDF 衍生能力弱，以摘要和问答为主。
• 集成方式：book-to-skill 是 Claude Code 原生 Skill，通过终端命令调用；NotebookLM 提供 Web 和移动端 App，也可封装为 Claude Skill；ChatPDF 为 Web 应用，部分支持 API。
• 离线与本地支持：book-to-skill 完全本地，无需联网（除 Claude API）；NotebookLM 必须联网，依赖 Google 服务；ChatPDF 必须联网，云端处理。

应用场景

• 技术书籍深度研读：将厚重技术书籍转化为可调用技能，随时通过“/技能名 关键词”查阅特定框架、算法或反模式，无需翻找 PDF。
• 多源资料整合管理：把散落在不同文件夹的论文、笔记、导出文档批量合并为一个统一技能，实现跨文档的关联知识调用。
• 编码工作流实时参考：在 Claude Code 中写代码时，直接调用书籍中的设计模式或最佳实践，让知识随工作流即时可用，无需切换浏览器或笔记软件。
• 团队内部知识库构建：将公司内部技术规范、最佳实践文档或培训材料编码为 Skill，新成员可通过对话快速调用和学习。
• 冷门与内部资料处理：针对 Claude 训练数据中不存在的小众技术参考书、内部文档或最新出版物，建立基于原文的零幻觉知识库。
• 快速复习与考前速查：用生成的速查表和术语表，通过“/技能名”快速定位关键术语、决策表和章节要点，替代传统笔记。