Book to Skill 教程：技术PDF教材转Claude Code技能文件

简介

Book to Skill 是一个拥有 18.8k 星数的开源工具，能够将技术 PDF 教材自动转换为 Claude Code 可用的技能文件（SKILL.md）。它通过 PDF 解析、内容结构化和技能模板生成三个步骤，将数百页的技术书籍浓缩为 AI 编程助手可理解的结构化知识。这与 Superpowers AI 编程技能 的理念一脉相承，但专注于从现有书籍中提取知识。

核心功能

功能	说明	输出格式
PDF 解析	支持图文混排、代码块、表格的精准提取	结构化文本
章节分割	自动识别书籍章节结构	章节树 JSON
技能提取	从内容中提取可操作的技能步骤	SKILL.md
代码示例提取	识别并格式化书中的代码示例	可执行代码块
多书籍合并	支持多本书的知识合并为统一技能	合并 SKILL.md
质量评估	评估生成技能文件的完整度和准确性	评分报告

安装

# pip 安装
pip install book-to-skill

# 从源码安装
git clone https://github.com/book-to-skill/book-to-skill.git
cd book-to-skill
pip install -e .

# 验证安装
b2s --version

# 安装 PDF 依赖
pip install "book-to-skill[pdf]"
# 或手动安装 pymupdf
pip install pymupdf

使用示例

# 基本用法：转换单本 PDF
b2s convert --input "machine-learning.pdf" \
  --output ./skills/ \
  --title "机器学习实战技能" \
  --format skill-md

# 高级用法：指定章节和深度
b2s convert --input "design-patterns.pdf" \
  --output ./skills/ \
  --chapters "3,5,7-10" \
  --depth detailed \
  --include-exercises \
  --model "claude-sonnet-4-20250514"

# Python API 使用
from book_to_skill import BookToSkill

converter = BookToSkill(model="claude-sonnet-4-20250514")
result = converter.convert(
    pdf_path="clean-code.pdf",
    output_dir="./skills/",
    options={
        "depth": "detailed",
        "include_code": True,
        "include_exercises": True,
        "max_skills_per_chapter": 5,
        "language": "zh-CN"
    }
)

print(f"生成技能文件: {len(result.skill_files)}")
for skill in result.skill_files:
    print(f"  - {skill.title}: {skill.word_count} 字")
    print(f"    路径: {skill.path}")

# 合并多本书为一个技能
b2s merge \
  --inputs "book1.pdf" "book2.pdf" "book3.pdf" \
  --output ./skills/unified-coding-skill.md \
  --title "统一编码最佳实践"

方案对比

方案	输入	输出	自动化程度	技能质量
Book to Skill	PDF 教材	SKILL.md	全自动	高
手动编写技能	人工知识	SKILL.md	手动	取决于人
RAG + PDF	PDF	实时检索	半自动	中
摘要工具	PDF	摘要文本	全自动	低

总结

Book to Skill 解决了一个关键问题：如何将已有的技术书籍知识转化为 AI 编程助手可用的技能。18.8k 的星数证明了这一需求的广泛性。对于想要快速将团队的技术积累转化为 Claude Code 技能文件的团队，这个工具可以节省大量手动整理时间。MIT 协议意味着你可以自由地在商业项目中使用它。