技术书 PDF 在吃灰这个 GitHub 万星开源工具把它一键变成 Claude Code 技能

GitHub 上最近有个叫 book-to-skill 的项目，干一件事。

把任意一本技术书、论文、文档，转成 Claude Code 能直接调用的技能。

它一周冲到 1 万星出头，MIT 协议，作者 virgiliojr94。2026 好用的开源 AI 工具一抓一大把，但能把你硬盘里吃灰的 PDF 盘活的不多，这个算最被低估的那个。

它解决的不是「再开一个聊天框」，而是另一个更麻烦的问题。

你存过的那些书，AI 根本不知道。

它到底吐出来什么

喂进去一份文档，出来一个技能目录。

输入支持 PDF、EPUB、DOCX、TXT、Markdown、HTML、RTF，连 MOBI 都吃。

输出落在 ~/.claude/skills/<你的技能名>/，结构长这样：

SKILL.md 放核心思维模型和章节索引，大约 4000 token。

chapters/ch01-*.md 每章一个文件，每章约 1000 token，用到才加载。

glossary.md 术语表，按字母排好，带章节出处。

patterns.md 技术、算法、设计模式。

cheatsheet.md 决策表和速查规则。

最关键的一句，章节文件是按需加载的，没被问到就不进上下文，不白烧 token。

你那堆 PDF 现在的真实状态

买的时候都想着「总有一天用得上」。

结果躺在 Download 文件夹里，连文件名都记不清。

想查一个点，得先想起「好像某本书讲过」，再翻半天找到那本，再搜关键词。

AI 更惨，它不知道你存过这些书，每次都从零开始编。

book-to-skill 干的事，等于把你的私人书架，接进了 Claude Code 的脑子里。

装上去只要一条命令

Claude Code 用户直接克隆：

git clone https://github.com/virgiliojr94/book-to-skill.git ~/.claude/skills/book-to-skill

下次开 Claude Code 会自动认出这个技能，不放心就手动 /skills reload 一下。

想知道 Claude Code 怎么装技能，上面这条就是全部。

不想挂技能、只想纯提取文字，也能走 pip：

pip install "book-to-skill[pdf,epub,docx]"

装完在终端直接跑：

book-to-skill ~/path/to/book.pdf --mode text

真正好用的几种打开方式

单本书最朴素：

/book-to-skill ~/path/to/your-book.pdf

多份材料合并成一个技能，论文加笔记一起喂：

/book-to-skill ~/papers/paper1.pdf ~/notes/export.txt unified-research

整文件夹全收：

/book-to-skill ~/workspace/project-docs/ project-knowledge

用 glob 批量：

/book-to-skill "~/books/*.epub" my-library

生成之后怎么用，举个实在例子。

把《Designing Data-Intensive Applications》转成技能，直接问 /designing-data-intensive-applications replication，AI 会带着第五章出处给你讲复制。

不是联网瞎搜，是你那本书的原文结构。

两种模式别选错

--mode technical 走 Docling，适合公式多、图表多的技术书。

--mode text 走 pdftotext，纯文字书更快更轻。

技术书拿 text 模式跑，公式和代码块容易丢，这条记住。

确认装了哪些提取器，跑 book-to-skill --check 就行。

几个要注意的地方

MIT 只覆盖这个转换工具的代码，不覆盖你处理的书。商用或外传技能前，书本身的版权自己掂量。

大书生成的章节文件会很多，首次转换要吃一波 token，之后提问才按需加载，别被第一次的消耗吓退。

Windows 上路径走 PowerShell，~ 展开成用户目录那套，别直接抄 macOS 的写法。

技能是给「你自己用的 Claude Code」加记忆，不是发给别人用的产品。它解决的是「你读过的书，AI 也读得到」。

今天就能试的一件事

翻出你买过却没读完、但工作里常要查的那本技术书。

跑一次 /book-to-skill ~/路径/那本书.pdf。

明天遇到相关问题，直接问 AI 带章节出处，你会明显感觉它「读过这本书了」。