book-to-skill

概览

GitHubGitHub

book-to-skill 是一个开源工具，用于将技术书籍、文档文件夹或其他结构化文本转换为符合 Agent Skills 开放标准的统一 agent skill。它支持 GitHub Copilot CLI、Amp、Claude Code、Hermes Agent 和 OpenClaw 等宿主环境。 ## 解决什么问题 阅读技术书籍后容易遗忘内容，而直接搜索 PDF 只能得到页码列表，让 AI agent 回答则可能产生幻觉或提示缺少上下文。book-to-skill 通过将书籍转化为结构化的 skill，使 agent 能够按需加载对应章节并基于实际内容回答问题。 ## 工作流程 1. **指定输入**：指向文件、文件夹或 glob 模式，例如 `/book-to-skill ./my-book.pdf`。 2. **提取与生成**：工具将书籍提炼为 skill，包含框架、决策规则、反模式以及按章节拆分的文件。这是结构化处理而非简单摘要。 3. **按需加载**：agent 在需要时加载对应内容，例如输入 `/my-book replication`，它会读取相关章节并基于真实内容作答。 ## 生成的文件结构 转换后会在 `~/.agents/skills/<slug>/` 目录下生成以下文件： - **SKILL.md**：核心心智模型与章节索引，约 4000 tokens。 - **chapters/ch01-*.md**：每章一个文件，按需加载，每个约 1000 tokens。 - **glossary.md**：按字母排序的关键术语表及章节引用，约 1500 tokens。 - **patterns.md**：技术、算法和设计模式汇总，约 2000 tokens。 - **cheatsheet.md**：决策表和快速参考规则，约 1000 tokens。 章节文件仅在查询相关主题时才被加载，不占用 skill 的 token 预算。 ## 适用场景 除了书籍，该工具也适用于内部文档（架构决策记录、运维手册）、品牌与设计系统规范、研究论文集合以及 RFC、API 契约等标准文档。 ## 性能 相比将整本书直接放入上下文中回答问题，book-to-skill 可减少 24 至 51 倍的 token 消耗。其架构由确定性的 Python 提取器（将文档转为干净文本和元数据）和规范驱动的生成器组成。

Q&A

book-to-skill 支持哪些文档格式？由 AI 生成

支持 PDF、EPUB、DOCX、MD、HTML、RTF 和 MOBI 格式。

生成的 skill 可以在哪些工具中使用？由 AI 生成

支持所有兼容 Agent Skills 开放标准的宿主，包括 GitHub Copilot CLI、Amp、Claude Code、Hermes Agent 和 OpenClaw。

skill 生成后会存放在哪里？由 AI 生成

默认存放在用户级跨 agent 技能目录 ~/.agents/skills/<slug>/ 下。Hermes Agent 会存放在 $HERMES_HOME/skills/<category>/<slug>/。

它能节省多少 token？由 AI 生成

根据在真实书籍上的测量，相比将整本书直接放入上下文中回答问题，可减少 24 至 51 倍的 token 消耗。

除了书籍还能处理什么内容？由 AI 生成

可以处理任何结构化文本，包括内部文档（架构决策记录、运维手册）、品牌设计系统、研究论文集合以及 RFC 和 API 契约等规范文档。

基本的使用命令是什么？由 AI 生成

使用 /book-to-skill <path|folder|glob> [skill-name] 命令即可进行转换。