Repolode
virgiliojr94

virgiliojr94/book-to-skill

将技术书籍和文档转换为可供 AI 编程助手按需调用的结构化 Agent Skill。

Star
35,351
Fork
3,728
未关闭 Issue
24
最近提交
前天

这是什么?

book-to-skill 可以读取 PDF、EPUB、DOCX、Markdown、HTML 等格式的文档,也可以处理整个文件夹的资料,将其提炼为 Agent Skills 格式的技能包。输出内容包括带有核心概念与章节索引的 SKILL.md,按需加载的分章文件,以及术语表、模式汇总和速查表。它保留的是书籍的结构而非简单摘要,因此智能体可以基于实际章节内容作答。

工具以斜杠命令的形式运行:Python 提取器先把原文转换为干净的文本和元数据,再由智能体按照生成规范构建技能。生成的技能会放入跨智能体的 skills 目录,GitHub Copilot CLI、Amp、Codex、OpenCode、OpenClaw 等环境均可直接读取,Claude Code 与 Hermes Agent 也有对应的安装位置。

同样的方法也适用于内部文档、品牌规范、论文合集和经常查阅的技术规范。处理受版权保护的材料时,项目建议使用自己拥有的副本在本地完成,并将结果保留为私人资料。

核心功能

  • 01支持将 PDF、EPUB、DOCX、HTML、RTF、MOBI 和 Markdown 转换为 Agent Skills 技能包。
  • 02生成 SKILL.md 索引和分章文件,仅在询问相关主题时加载。
  • 03同时输出术语表、模式汇总和速查表。
  • 04内置提取器,提供 --check 命令检查各格式所需工具是否安装。
  • 05兼容多个支持 Agent Skills 标准的智能体环境。

适用场景

  • 在编程时通过 Claude Code 或 Copilot CLI 直接查询技术书籍内容。
  • 将架构决策记录或运维手册文件夹整理成团队可用的技能。
  • 让智能体能够检索一组研究论文和个人笔记。
  • 学习厚重的技术书时,按章节或概念向智能体提问。

快速上手

  1. 1

    使用跨代理技能 CLI 安装该技能

    npx skills add virgiliojr94/book-to-skill
  2. 2

    检查已安装的提取器,并获取缺失项的安装命令

    python3 scripts/extract.py --check
  3. 3

    在 AI 编程助手中将书籍或文档文件夹转换为技能

    /book-to-skill <path|folder|glob> [skill-name]

使用前须知

  • 需要支持 Agent Skills 标准的 AI 编程助手,例如 Claude Code 或 Codex。
  • 没有文本层的扫描版 PDF 必须先进行 OCR,否则提取器会停止。
  • PDF、EPUB、DOCX 和 MOBI 的提取依赖可选工具,可能需要单独安装。

标签

常见问题

book-to-skill 是什么?
将技术书籍和文档转换为可供 AI 编程助手按需调用的结构化 Agent Skill。 book-to-skill 可以读取 PDF、EPUB、DOCX、Markdown、HTML 等格式的文档,也可以处理整个文件夹的资料,将其提炼为 Agent Skills 格式的技能包。输出内容包括带有核心概念与章节索引的 SKILL.md,按需加载的分章文件,以及术语表、模式汇总和速查表。它保留的是书籍的结构而非简单摘要,因此智能体可以基于实际章节内容作答。
book-to-skill 可以免费使用吗?用的什么许可证?
book-to-skill 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
book-to-skill 还在维护吗?
活跃维护中。book-to-skill 最近一次提交是在 2026年10月18日。
book-to-skill 适合用来做什么?
在编程时通过 Claude Code 或 Copilot CLI 直接查询技术书籍内容。 将架构决策记录或运维手册文件夹整理成团队可用的技能。 让智能体能够检索一组研究论文和个人笔记。 学习厚重的技术书时,按章节或概念向智能体提问。
book-to-skill 怎么安装和运行?
使用跨代理技能 CLI 安装该技能: npx skills add virgiliojr94/book-to-skill 检查已安装的提取器,并获取缺失项的安装命令: python3 scripts/extract.py --check 在 AI 编程助手中将书籍或文档文件夹转换为技能: /book-to-skill <path|folder|glob> [skill-name]
在哪里获取 book-to-skill?
源代码和安装说明在 GitHub 上:https://github.com/virgiliojr94/book-to-skill

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目