book-to-skill：一个真正把文档转成可执行

大模型读长文档太费上下文，有人写了 book-to-skill 把书拆成按需加载的技能包。

它先把 PDF、EPUB 转成带结构的 Markdown。再让 Agent 按问题只拉相关章节。号称能省几十倍 token，一本转换成本约一美元。

这活儿分两半干。前半截是纯 Python 提取器，不靠 AI，负责把书拆碎。后半截交给宿主 Agent，照着规约拼成最终的技能文件树。

工程底子挺硬。支持十来种格式，缺依赖还能降级兜底。代码里还防了不可见字符和 XXE 攻击。测试有 232 个函数，质量确实扎实。

不过也有坑。生成步骤必须调外部 Agent，离线一键出成品这事做不到。扫描版 PDF 得先 OCR，没标题的书只能按长度硬切。处理技术 PDF 时，重型模式慢得离谱，比普通文本慢一千多倍。

说白了，想把技术书变成 Agent 知识库，这套很能打。但要是只想做个简单的 PDF 转 Markdown，直接上轻量工具就行。