软鉴SoftMemo
浏览软件目录

book-to-skill 是供 AI 编程助手使用的文档转技能工具，可将技术书籍、文档目录或多份资料整理成可复用的 Agent Skill。生成内容包含知识框架、决策规则及分章文件，供助手按主题加载，适合把经常查阅的技术资料带入日常开发流程。

适合希望在编码时反复查阅技术书籍的开发者 · 需要查询团队架构决策和操作手册的工程师 · 持续积累同一主题论文与笔记的研究者

亮点

  1. 把书籍变成工作知识

    提取知识框架、决策规则和反模式，让助手在工作中调用资料，而不只是生成摘要。

  2. 按需加载相关章节

    章节文件在询问对应主题时才加载，避免每次都把整本书放入上下文。

  3. 兼容多种技能宿主

    使用 Agent Skills 标准，可供 Claude Code、Amp 等助手读取。

功能说明

资料输入与转换

  1. 处理文件与目录

    可指定单个文件、文件夹或通配路径作为转换输入。

  2. 导入常见电子书与文档格式

    支持 PDF、EPUB、DOCX、HTML、RTF、MOBI，以及纯文本和 Markdown 等格式；所需提取依赖因格式而异。

  3. 合并多来源资料

    可将研究论文与个人笔记合成技能，也能处理内部文档目录。

  4. 分阶段生成与更新

    提供仅分析、从分析结果生成，以及更新或并入资料的模式。

技能使用与分发

  1. 按主题查询内容

    通过生成技能的名称和主题提问，让助手读取对应章节。

  2. 发布转换结果

    转换后可发布到 GitHub，默认私有，供宿主通过技能 CLI 安装。

转换器安装与宿主发现

  1. 通过技能 CLI 或手动克隆安装转换器

    可用 npx skills add virgiliojr94/book-to-skill 将完整技能安装到所选宿主，也可将仓库克隆到宿主的技能目录；技能安装包含提取脚本及辅助工具。

  2. 按宿主选择手动安装目录

    Claude Code 使用 ~/.claude/skills/，GitHub Copilot CLI 可使用 ~/.copilot/skills/；Copilot CLI、Amp 和 Codex 可共享 ~/.agents/skills/。OpenCode 也读取该共享目录及自身的 ~/.config/opencode/skills/；未立即发现时可启动新会话。

  3. 为 Hermes 与 OpenClaw 使用各自的技能目录

    Hermes 使用 ${HERMES_HOME:-$HOME/.hermes}/skills/<category>/，安装后启动新会话；项目本地技能需先信任项目。OpenClaw 可安装到当前状态目录的 skills/，共享 ~/.agents/skills/ 仅在默认状态目录下被发现，可用 openclaw skills list 核对。

  4. 选择个人或项目本地的生成位置

    生成技能默认放在个人级目录；明确要求时可输出到宿主的项目本地目录，便于随项目共享，但写入项目可能需要宿主批准。

适合场景

  1. 希望在编码时反复查阅技术书籍的开发者

    可将书中框架、规则与章节组织成助手技能，按当前问题读取相关内容。

  2. 需要查询团队架构决策和操作手册的工程师

    支持把内部文档目录整理成技能，适合在开发过程中查询经常重读的项目资料。

  3. 持续积累同一主题论文与笔记的研究者

    可将多份研究资料合并为技能，并通过更新或并入模式加入后续材料。

取舍

选它的理由

  • 生成的知识包不止包含章节摘要除核心心智模型和章节索引外，还生成带章节引用的术语表、技术与设计模式清单，以及决策表和速查规则，方便按不同问题查找资料。
  • 根据文档内容选择提取工具转换前会询问书籍偏技术内容还是以文字为主，并自动选择工具；Docling 用于保留 Markdown 表格和代码块，pdftotext 适用于以文字为主的书籍。
  • 跨助手共享生成技能，并验证 Claude Code 的发现链接默认跨助手目录可由 Copilot CLI、Amp、Codex 和 OpenCode 直接发现；在 Claude Code 中运行时，转换器会尝试创建符号链接，仅在回读验证成功后技能才可被发现，否则运行报告会说明未成功。Hermes 不扫描跨助手根目录，安装时改用其分类技能目录。

先想清楚

  • 不适合要求扫描书籍直接完成识别与转换的任务

使用须知

  • 扫描版 PDF 需先自行完成 OCR对于没有文字层的页面图片，提取器会检查前几页并停止；需先用其他工具识别文字，再转换处理后的 PDF。
  • 部分格式需要额外安装提取工具PDF 需可用的提取器，MOBI、AZW 和 AZW3 依赖外部 Calibre；纯文本、Markdown、reStructuredText 和 AsciiDoc 无需额外提取依赖。
  • 自定义 OpenClaw 状态目录需调整输出位置OpenClaw 仅在默认状态目录配置下发现共享的 ~/.agents/skills/；非默认配置可使用当前状态的 skills/、工作区技能目录或显式配置的额外目录。转换器不会推断任意额外目录配置，使用这些目录时需通过 openclaw skills list 明确验证生成路径。
  • 单独安装 pip CLI 不能获得完整技能转换流程该渠道只安装文本提取引擎，不注册 /book-to-skill 技能；完整流程需安装 Agent Skill。CLI 尚未发布到 PyPI，需从项目仓库安装。
  • Hermes 项目本地技能需先获得项目信任未信任项目时，Hermes 不加载该项目 .hermes/skills/ 或 .agents/skills/ 中的技能；信任后需启动新会话。

同分类软件

查看全部

更多「编码辅助」软件

软鉴 SoftMemo

AI 整理的软件知识库

AI 整理软件资料、版本动态、更新通知、订阅权益与对比分析，沉淀可复用的工具知识。

进入软鉴浏览软件目录
打开来源