假如书籍会说话

它能做什么

把一本书、一个文档文件夹或多份相关资料转成可反复调用的 Agent Skill。Python 提取器先生成干净文本与元数据，Agent 再按根目录 SKILL.md 组织作者框架、原则、技巧、反模式和章节索引；后续按问题读取相关章节。独立 CLI 仅做提取，不会单独生成完整 Skill。

主要能力

• 支持单文件、文件夹、glob 或多个路径，合并相关资料；可选择完整转换、只分析、依据已有分析生成、向已有 Skill 合并新资料。
• 将 framework、mental model、principle、technique、anti-pattern 整理进主 SKILL.md 和按章节读取的文件，另有 glossary.md、patterns.md、cheatsheet.md。
• 生成的主文件包含核心框架、章节与主题索引；Agent 后续按需读取章节，而不是每次将原书全文放入上下文。

支持的文件

• TXT/Markdown/reStructuredText/AsciiDoc 直接读取；EPUB、DOCX、HTML、RTF 可用内置回退解析，安装对应可选库可改善提取。
• PDF 需要 pdftotext、pypdf 或 pdfminer.six 等提取器；技术类 PDF 可用可选 docling。图片扫描 PDF 须先自行 OCR。
• MOBI、AZW、AZW3 必须另装 Calibre，并让 ebook-convert 可执行。

支持哪些 AI

仓库当前文档列出 GitHub Copilot CLI、Amp、Claude Code、Codex、Hermes Agent、OpenClaw，以及兼容 Agent Skills 的宿主。各环境的 skills 路径和刷新/信任要求不同；OpenClaw 非默认 state 不会自动读取 ~/.agents/skills。

适合谁

• 需要长期按主题查阅专业书、研究资料或自有文档的学习者和研究人员。
• 想把合法可处理的内部文档、规范或个人资料组织为可调用知识 Skill 的团队与 Agent 用户。

使用条件与注意事项

• Python >=3.9；Agent Skill 方式还需要可读写文件、可执行提取脚本的兼容宿主。PDF 等格式依赖按上表安装；--check 可核查本机。
• 缺少可选 Python 包时交互模式可能询问是否通过 pip 安装；--install-missing yes 会自动安装。安装与可选 GitHub 发布会联网；工具本身的本地提取不上传文件或运行网络服务，云模型接收的文本遵循服务商数据条款。
• 仅处理可信且有权处理的文档；项目扫描生成 Skill 中的可疑指令，但只是提示性检查。MIT 仅授权转换器本身，不自动授权公开分发由第三方有版权书籍生成的 Skill。