virgiliojr94/book-to-skill

Turn any technical book PDF into a Claude Code skill — ready to study, reference, and use while you work.

解决的问题

许多技术书籍和长文档难以被 AI 代理有效查询。简单地将整本书塞入 LLM 的上下文窗口会消耗大量 token，且常常导致幻觉或导航错误。该工具将这些文档转换为结构化的“技能”，AI 代理可按需加载，从而实现精确、低 token 的查询，无需手动搜索 PDF。

工作原理

该项目采用两部分流程：一个基于 Python 的提取器，将各种文件格式（PDF、EPUB、DOCX 等）转换为干净的文本和元数据；以及一个规范驱动的生成器，将内容组织成结构化的技能格式。它不是创建单个大文件，而是创建一套文件系统，包括核心的 SKILL.md（心智模型和索引）、用于按需加载的各个章节文件、词汇表和速查表。这确保了代理仅在需要时读取书籍的相关部分。

适用人群

适用于经常参考技术书籍、内部公司文档、架构决策记录或研究论文的开发者和研究人员，并希望将这些知识直接集成到他们的 AI 编码助手（如 GitHub Copilot CLI、Claude Code 或 OpenCode）中。

亮点

多格式支持：从 PDF、EPUB、DOCX、HTML、RTF 和 MOBI 中提取文本。
Token 效率：与全上下文转储相比，token 使用量减少 24 倍至 51 倍。
跨代理兼容性：遵循 Agent Skills 开放标准，使其兼容多种 AI 代理主机。
本地处理：所有提取和分析均在本地进行，以保护隐私。
技术 PDF 处理：使用 docling 等专业工具保留技术文档中的 Markdown 表格和代码块。