book-to-skill

面对厚重的技术书籍，你是否常陷入“买书如山倒，读书如抽丝”或“读完就忘”的困境？book-to-skill 是一款专为 Claude Code 设计的开源工具，它能将任何技术书籍或文档自动转化为结构化的 AI 技能（Skill）。通过按需加载章节、提取核心模式与术语，它让书籍不再是沉睡的 PDF，而是你编码过程中随时可调用的精准知识助手。

核心亮点：结构化、按需加载、零幻觉

1. 深度结构化提取

book-to-skill 不只是简单切片，而是将书籍重构为五个核心模块：

• SKILL.md：核心心智模型 + 全书章节索引（~4k tokens），作为入口指南。
• chapters/：每章独立文件，按需加载，仅在查询相关主题时计入上下文，节省 Token。
• glossary.md：按字母排序的关键术语表，附带章节引用，快速定位概念。
• patterns.md：提取书中的技术、算法及设计模式，便于实战参考。
• cheatsheet.md：决策表与快速参考规则，加速日常决策。

2. 精准检索，拒绝幻觉

• 基于真实内容：Claude 直接阅读结构化后的章节文件，而非依赖模糊的记忆或通用知识，确保回答有据可依。
• 高效定位：通过 /your-book-slug replication 或 /ch05 等指令，直接跳转至相关章节或主题，无需在数百页 PDF 中手动翻找。

3. 智能解析引擎

针对不同类型的书籍，自动选择最优提取工具：

• 技术类书籍（含代码/表格）：优先使用 Docling，保留 Markdown 格式与代码块结构。
• 文本为主书籍：使用 pdftotext 或 PyPDF2，极速提取纯文本。
• 多格式支持：兼容 PDF, EPUB, DOCX, TXT, Markdown, HTML, MOBI 等 10+ 种主流格式。

快速开始

1. 安装与依赖

确保已安装必要的解析工具（如 poppler-utils, docling, ebooklib 等），脚本会在首次运行时提示缺失依赖。

2. 生成技能

# 基本用法：从文件名派生技能名称
/book-to-skill ~/Downloads/designing-data-intensive-applications.pdf

# 指定自定义名称
/book-to-skill ~/books/clean-code.epub clean-code

# 完整路径
/book-to-skill /tmp/ddd-evans.pdf domain-driven-design

生成的技能将保存在 ~/.claude/skills/<slug>/ 目录下。

3. 在 Claude Code 中使用

# 加载核心心智模型
/designing-data-intensive-apps

# 查询特定主题（自动加载相关章节）
/designing-data-intensive-apps replication

# 深入特定章节
/designing-data-intensive-apps ch05

# 查看可用章节
/designing-data-intensive-apps "what chapters do you have?"

为什么选择 book-to-skill？

适用场景

• 即时查阅：在编码遇到难题时，快速查询《设计数据密集型应用》中的复制策略或《清洁代码》中的重构原则。
• 深度学习：通过 patterns.md 系统学习书中的设计模式，并通过 cheatsheet.md 快速回顾关键点。
• 知识内化：将晦涩的技术文档转化为易于交互的问答形式，加速理解与记忆。
• 团队共享：将团队内部的技术规范或最佳实践文档转化为 Skill，统一团队认知。