星标数：37760★ Fork数：4009 《book-to-skill：把技术书PDF变成按需加载的Agent技能》

book-to-skill 可以把任何技术书籍、文档文件夹或资料集合，转换成统一的 Agent 技能（skill），让你在工作中随时学习、查阅和使用。它支持 GitHub Copilot CLI、Amp、Claude Code、Codex、Hermes Agent、OpenCode 和 OpenClaw 等多种宿主。

整个过程只有三步：首先用 /book-to-skill ./my-book.pdf 指向一个文件、文件夹或 glob 模式；接着它会把书提炼成一个结构化技能——包含框架、决策规则、反模式和按章节组织的文件（是结构，不是摘要）；最后你的 Agent 按需加载它——输入 /my-book replication，它会读取对应章节并基于真实内容作答，不会产生幻觉。

与把整本书塞进上下文相比，它的 token 消耗少 24×–51×（在真实书籍上实测），转换时一次性付清结构化成本，让每次查询的开销与答案规模成正比。

主要特点

• 支持 PDF、EPUB、DOCX、MD、HTML、RTF、MOBI 等多种格式
• 生成的技能符合开放的 Agent Skills 标准，可被多个 Agent 宿主原生发现
• 章节文件按需加载，单个文件约 1,000 tokens，不占用技能常驻预算
• 除书籍外，还适用于内部文档、品牌设计系统、研究论文和 RFC 规范等结构化文本
• 提供 analyze-only、generate-from-analysis 和 update/fold-in 等多种模式，转换后可发布到 GitHub 供任何宿主安装
• 采用 MIT 许可证

生成的技能包含以下文件，统一存放在 ~/.agents/skills/<slug>/ 目录下：

• SKILL.md — 核心心智模型与章节索引（约 4,000 tokens）
• chapters/ch01-*.md 等 — 每章一个文件，按需加载
• glossary.md — 按字母排序的关键术语表，附章节引用
• patterns.md — 所有技术、算法和设计模式
• cheatsheet.md — 决策表与速查规则

安装

# 一条命令，任何宿主通用 —— 通过跨 Agent 的 skills CLI：
npx skills add virgiliojr94/book-to-skill

# 或手动安装 —— 克隆到你的 skills 目录（注册 /book-to-skill）：
git clone https://github.com/virgiliojr94/book-to-skill.git ~/.claude/skills/book-to-skill
# (Copilot CLI: ~/.copilot/skills/ · Amp/跨 Agent: ~/.agents/skills/)

📊 本项目 GitHub 星标数：37760。最后更新：2026-11-03，发布：2026-08-10。项目地址：https://github.com/virgiliojr94/book-to-skill