book-to-skill 支持哪些文档格式？

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

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

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

skill 生成后会存放在哪里？

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

它能节省多少 token？

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

除了书籍还能处理什么内容？

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

基本的使用命令是什么？

使用 /book-to-skill [skill-name] 命令即可进行转换。

September 26, 2026

book-to-skill

AI & Machine Learning Prompt Engineering & Skill Management0

Get resource

将技术书籍 PDF 或文档集合转换为 AI Agent 可用的结构化 skill，供学习和工作参考。

MITClaude CodeText InputDocument InputText Output

Skill Packaging

安装 / 调用方式bash

转换完成后可发布到 GitHub，通过以下命令安装：
```
npx skills add
```

调用示例json

```
/book-to-skill ./my-book.pdf
/book-to-skill <path|folder|glob> [skill-name]
```

Product facts

Type: AI Skill & Agent
Category: AI & Machine Learning › Prompt Engineering & Skill Management
Pricing: Open source
Platforms: Claude Code
License: MIT
Launched: Sep 26, 2026
Listed: Sep 26, 2026
Website: github.com

Overview

GitHub GitHub

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 提取器（将文档转为干净文本和元数据）和规范驱动的生成器组成。

Key features

多格式输入支持：支持 PDF、EPUB、DOCX、MD、HTML、RTF、MOBI 等格式的文档作为输入源。
跨 Agent 兼容：生成的 SKILL.md 可被 GitHub Copilot CLI、Amp、Claude Code、Hermes Agent、OpenClaw 读取。
按需加载章节：章节文件独立存储，仅在查询相关主题时加载，不占用初始 token 预算。
结构化知识提取：从文档中提取框架、决策规则、反模式、术语表和设计模式，而非生成简单摘要。
Token 消耗优化：相比将整本书放入上下文，可减少 24 至 51 倍的 token 消耗。
多种输入方式：支持单个文件、文件夹、glob 模式或文件列表作为转换输入。
更新与合并模式：支持 update/fold-in 模式，可在已有 skill 基础上合并新材料。
发布到 GitHub：转换后可将 skill 发布到 GitHub（默认私有），通过 npx skills add 安装。
自动符号链接：在 Claude Code 下运行时，会尝试在 ~/.claude/skills/ 创建经验证的符号链接。

Releases

Notify me

Initial · book-to-skill

September 26, 2026

Q&A

book-to-skill 支持哪些文档格式？AI-generated: 支持 PDF、EPUB、DOCX、MD、HTML、RTF 和 MOBI 格式。
生成的 skill 可以在哪些工具中使用？AI-generated: 支持所有兼容 Agent Skills 开放标准的宿主，包括 GitHub Copilot CLI、Amp、Claude Code、Hermes Agent 和 OpenClaw。
skill 生成后会存放在哪里？AI-generated: 默认存放在用户级跨 agent 技能目录 ~/.agents/skills/<slug>/ 下。Hermes Agent 会存放在 $HERMES_HOME/skills/<category>/<slug>/。
它能节省多少 token？AI-generated: 根据在真实书籍上的测量，相比将整本书直接放入上下文中回答问题，可减少 24 至 51 倍的 token 消耗。
除了书籍还能处理什么内容？AI-generated: 可以处理任何结构化文本，包括内部文档（架构决策记录、运维手册）、品牌设计系统、研究论文集合以及 RFC 和 API 契约等规范文档。
基本的使用命令是什么？AI-generated: 使用 /book-to-skill <path|folder|glob> [skill-name] 命令即可进行转换。