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