Hermes Edu Skills

让 Hermes Agent 和主流 AI 工具拥有中国教育场景能力的开源 Agent Skill Pack：学前启蒙、教材同步、备考复习、错题复盘、每日练习、亲子陪学、阅读写作和教师工作流。

An open Agent Skill Pack that gives Hermes Agent and mainstream AI tools China-focused education capabilities: preschool learning, textbook sync, exam prep, mistake review, daily practice, family learning, reading/writing, and teacher workflows.

English · Skill Catalog · Discovery Index · Shineway

Hermes Edu Skills 是一套面向中国教育场景的开源 Agent Skill Pack。它把学前启蒙、教材同步、考试备考、拍照答疑、错题复盘、每日练习、阅读写作、亲子陪学、教师备课和家校沟通，整理成 188 个可浏览、可安装、可二次开发的产品级 Skill。

它不是 Prompt 合集，而是可被 Hermes Agent 识别的结构化能力库：每个 Skill 都有触发信号、适用角色、参数维度、使用边界和标准 SKILL.md。你可以直接装进 Hermes Agent，也可以导出给 OpenClaw、Codex、Cursor、Claude Code 或其它 Agent 工具。

如果你正在做 AI 学习助手、AI 老师、教研工具、家长陪学产品、题库/错题产品，或者只是想让自己的本地 Agent 更懂中国教材和学习场景，这个仓库可以直接作为起点。觉得有帮助的话，欢迎 Star，它会帮助更多中文教育 AI 开发者更快发现这个项目。

导航

• 5 分钟上手
• 这是什么
• 为什么不是 Prompt 集合
• 谁适合用
• 分类总览
• 默认使用：Hermes Agent
• 让 Hermes 更主动发现 Skill
• 自然提问与 Skill 路由
• 诊断与排障
• 只安装单个 Skill
• 导出给其它 AI 工具或 Agent
• 覆盖范围
• 全部 Skill 列表
• 参与贡献
• 路线图

5 分钟上手

默认目标是 Hermes Agent。第一次试用建议先安装一个分类或一个 Skill，确认效果后再安装全部。

# 一键安装并启用全部 188 个可用 Skill。安装后继续用 hermes / hermes chat 即可
npx --yes hermes-edu-skills install

# 只安装教材同步分类
npx --yes hermes-edu-skills install textbook-sync

# 只安装一个 Skill
npx --yes hermes-edu-skills install agent-study-plan

# 搜索你需要的能力
npx hermes-edu-skills search 错题
npx hermes-edu-skills info agent-mistake-review

# 像普通 Agent 一样直接提问：先显示匹配到的 Skill，再调用 Hermes
npx hermes-edu-skills ask "帮我出5道八年级下册物理力学选择题"

# 启动原生 Hermes 会话，并强制启用 skills toolset
npx hermes-edu-skills chat

# 只查看或手动生成项目级 Hermes Edu Skills 启动 Prompt
npx hermes-edu-skills prompt > HERMES.md

# 诊断安装数量、版本、配置和 Hermes 可见性
npx --yes hermes-edu-skills doctor

# 自动修复 / 更新 / 验证 / 卸载
npx --yes hermes-edu-skills fix
npx --yes hermes-edu-skills repair
npx --yes hermes-edu-skills update
npx --yes hermes-edu-skills verify
npx --yes hermes-edu-skills uninstall

导出给其它 Agent 或 AI 工具：

npx hermes-edu-skills install openclaw
npx hermes-edu-skills install codex
npx hermes-edu-skills install claude
npx hermes-edu-skills install cursor --workspace /path/to/project
npx hermes-edu-skills export generic --target ./dist/agent-skills

这是什么

| 问题 | 答案 | | --- | --- | | 这是什么 | 面向中国教育场景的开源 Agent Skill Pack。 | | 为什么需要 | 通用 Agent 通常不理解中国教材版本、年级册别、单元节奏、考试体系和家庭/教师真实工作流。 | | 怎么实现 | 用 188 个结构化 SKILL.md 把教育任务封装成 Agent 可发现、可调用、可安装的能力。 | | 默认平台 | Hermes Agent。 | | 可导出平台 | OpenClaw、Codex、Cursor、Claude Code、Generic Agent。 | | 开源内容 | 公开 Skill 文档、索引、校验工具和导出工具；不包含用户数据、密钥或商业后端实现。 |

为什么不是 Prompt 集合

| 能力 | Prompt 集合 | 通用 Agent Skills | Hermes Edu Skills | | --- | :---: | :---: | :---: | | 中国教材版本对齐 | - | 通常不支持 | 支持人教、统编、北师大、苏教、鲁科等教育场景 | | 年级/册别/单元/难度 | 靠手写提示词 | 部分支持 | 作为 Skill 参数和工作流约束 | | 真实教育任务 | 松散模板 | 通用能力 | 教材同步、错题复盘、备考复习、每日练习、教师工具 | | Hermes 原生识别 | - | 不一定 | 标准 SKILL.md | | 多 Agent 复用 | - | 不一定 | 可导出到 OpenClaw、Codex、Cursor、Claude Code | | 中文教育表达 | 不稳定 | 不稳定 | 围绕中国学生、家长、老师和教研场景编写 | | 二次开发 | 低 | 中 | 有目录、索引、校验和安装工具 |

谁适合用

| 你是谁 | 推荐先看 | 可以得到什么 | | --- | --- | --- | | Hermes Agent 用户 | 默认使用：Hermes Agent、学习助手 | 直接把中文教育 Skill 加到本地 Agent。 | | 学前儿童家长 | 学前启蒙、家庭教育 | 用 10 分钟亲子任务做识字、数感、绘本、表达、专注、控笔和幼小衔接。 | | 教育 AI 开发者 | 项目结构、兼容说明 | 复用 Skill 结构、参数设计和工作流命名。 | | 老师 / 教研人员 | 老师工具、教材同步 | 参考备课、作业生成、单元复习和同步教学设计。 | | 家长 / 家庭教育产品 | 家庭教育、每日练习 | 构建陪伴、阅读、习惯和每日训练场景。 | | 学校 / 教培机构 | 老师工具、考试备考 | 了解备课、作业、班级分析、复习和教学支持产品形态。 |

分类总览

当前包含 188 个可安装 Skill，覆盖 8 个产品级分类。年级、册别、单元、课时、知识点和难度作为参数传入，不再拆成海量重复 Skill。

| 分类 | 安装选择器 | 适用场景 | 数量 | | --- | --- | --- | ---: | | preschool学前启蒙 | npx: preschoolnpm: --category preschool | 面向 3-6 岁、幼小衔接和亲子启蒙：识字、拼音、数感、绘本、表达、专注、控笔、生活习惯和入学准备。 | 22 | | textbook-sync教材同步 | npx: textbook-syncnpm: --category textbook-sync | 面向中国教材版本、年级、册别、单元、课时和知识点的同步学习能力。年级、册别、单元和难度作为参数传入，不再拆成大量独立 Skill。 | 40 | | daily-practice每日练习 | npx: daily-practicenpm: --category daily-practice | 面向每天短时高频训练，例如口算、听写、背诵、词汇、快速巩固。 | 26 | | reading-writing阅读写作 | npx: reading-writingnpm: --category reading-writing | 面向语文、英语、学术和职场表达的阅读与写作能力。 | 11 | | exam-prep考试备考 | npx: exam-prepnpm: --category exam-prep | 面向期末、中考、高考、考研、四六级、考证和公务员等备考场景。 | 30 | | learning-assistant学习助手 | npx: learning-assistantnpm: --category learning-assistant | 学习计划、拍照答疑、错题复盘、学情报告、专注训练、成人学习等通用学习闭环能力。 | 21 | | family-education家庭教育 | npx: family-educationnpm: --category family-education | 面向家长陪伴、亲子阅读、作业习惯和家庭沟通。 | 7 | | teacher-tools老师工具 | npx: teacher-toolsnpm: --category teacher-tools | 面向老师备课、作业生成、班级分析和家校沟通。 | 31 |

发起与维护

本项目由 长沙欣慰科技 发起并维护。

我们希望把可复用的教育 Agent Skill 设计开放出来，和开发者、老师、教研人员、学校及教育机构一起探索更适合中国教育场景的智能体能力。本仓库只包含公开 Skill 文档、索引、校验和导出工具，不包含用户数据或后端服务实现。

如果这个项目对你有帮助，欢迎给一个 Star；这会让更多中文教育 AI 开发者、老师和 Agent 用户更快找到它。

默认使用：Hermes Agent

Hermes Edu Skills 的默认目标是 Hermes Agent。仓库中的 skills/ 目录就是标准 Skill 源目录，不需要先转换格式。推荐优先使用正式 CLI；如果你是从 GitHub 源码运行，也可以继续使用下方源码模式命令。

如果你的环境暂时无法通过 npx 获取包，请直接使用后面的源码模式。

方法一：正式 CLI 安装（推荐）

npx --yes hermes-edu-skills install

这条命令会同时完成四件事：

• 安装 188 个可用 Skill，并写入 Hermes skills.external_dirs。
• 自动把 Hermes CLI 的 platform_toolsets.cli 合并为启用 skills，避免普通 hermes chat 无法访问 Skill 工具。
• 默认在当前目录生成项目级 HERMES.md 启动 Prompt，并在当前 Hermes Home 的 SOUL.md 中写入带标记的全局激活区块，让用户从其它目录直接运行 hermes 时也会优先检索 hermes-edu-skills。
• 自动发现 hermes config path；如果 Hermes 暂不可用，再使用 ~/.hermes/config.yaml。安装完成后，用户继续使用 hermes 或 hermes chat 即可。

安装后推荐重新打开一个 Hermes 会话：

hermes

如果你的 Hermes 安装使用了非默认配置，再指定配置文件：

npx --yes hermes-edu-skills install --config /path/to/config.yaml

如果你只安装某个分类或单个 Skill，安装器也会默认生成“范围收缩版” Prompt：分类安装会只列出该分类内的 Skill，单个 Skill 安装会明确要求 Hermes 在相关问题里优先加载这个具体 Skill。

如果不想生成 Prompt：

npx --yes hermes-edu-skills install --no-prompt

如果 HERMES.md 已存在，安装器不会覆盖；你可以运行 npx hermes-edu-skills prompt 查看内容，手动合并到已有项目指令中。全局 SOUL.md 只会维护 hermes-edu-skills 标记区块，不会覆盖用户原有内容。如果确实要覆盖项目级 HERMES.md，请加 --overwrite-prompt。

安装某个分类，例如教材同步：

npx --yes hermes-edu-skills install textbook-sync
npx --yes hermes-edu-skills install 教材同步

只安装一个 Skill 到 Hermes Agent：

npx --yes hermes-edu-skills install agent-study-plan

这也会默认生成只面向 agent-study-plan 的 HERMES.md，让 Hermes 在学习计划相关问题里优先调用这个 Skill。已有 HERMES.md 不会被覆盖；需要合并时可以运行 npx hermes-edu-skills prompt 查看全量提示，或重新安装时指定 --prompt-target。

先浏览和搜索：

npx hermes-edu-skills list
npx hermes-edu-skills list textbook-sync
npx hermes-edu-skills search 错题
npx hermes-edu-skills info agent-mistake-review
npx hermes-edu-skills version

安装后，你有两种使用方式：熟悉 Skill 名时直接用 Hermes 的 -s 手动指定；不知道该选哪个 Skill 时，用内置 Skill Router 自然提问，并让它先显示本次匹配到的 Skill。

# 启动原生 Hermes 会话。安装后通常直接 hermes 即可
npx hermes-edu-skills chat

# 用户日常更常用的启动方式
hermes

# 只查看匹配结果，不调用 Hermes
npx hermes-edu-skills match "八年级下册物理力学题"

# 自动匹配 Skill，并调用官方 Hermes Agent
npx hermes-edu-skills ask "帮我出5道八年级下册物理力学选择题"

更完整的使用场景见 自然提问与 Skill 路由。

方法二：源码模式安装（从 GitHub clone 后使用）

git clone https://github.com/zhongweiv/hermes-edu-skills.git
cd hermes-edu-skills
npm run validate
npm run install:hermes -- --config ~/.hermes/config.yaml
npm run install:hermes -- --category textbook-sync --config ~/.hermes/config.yaml
npm run install:hermes -- --skill agent-study-plan --config ~/.hermes/config.yaml

如果你只想先查看需要写入的 Hermes 配置：

npx hermes-edu-skills install hermes

然后在 Hermes 中验证：

hermes skills list

如果 Hermes 显示的数量和 README / catalog 不一致，先运行诊断：

npx --yes hermes-edu-skills doctor

详细排查路径见 诊断与排障。

也可以用 Hermes 的 Skill 工具验证：

from tools.skills_tool import skills_list, skill_view

skills_list()
skill_view("primary-math-mental-arithmetic")

让 Hermes 更主动发现 Skill

Hermes 原生的 Skill 选择是模型驱动的：它会先看到紧凑的 Skill 列表，再决定是否调用 skill_view(name) 读取完整 Skill。只安装 Skill Pack 并不等于每个普通提问都会自动触发 Skill。

因此 Hermes Edu Skills 提供了一个项目级启动 Prompt，用来明确告诉 Hermes：遇到中文教育、教材、练习、错题、备考、阅读写作、亲子陪学、教师备课等请求时，不要先直接回答，而是先在已安装的 hermes-edu-skills Skill Pack 中搜索，从 188 个可安装 Skill 里选择最匹配的一个，再调用 skill_view(name) 加载。

推荐用法：

# 只打印 Prompt，适合复制到已有 HERMES.md / .hermes.md
npx hermes-edu-skills pro