by zhongweiv
中文教育 Agent Skill Pack:教材同步、备考复习、拍照答疑、错题复盘、亲子陪学、阅读写作和教师工具,Hermes Agent 可直接使用,也可导出到 OpenClaw/Codex/Cursor/Claude Code。
# Add to your Claude Code skills
git clone https://github.com/zhongweiv/hermes-edu-skillsGuides for using ai agents skills like hermes-edu-skills.
No comments yet. Be the first to share your thoughts!
让 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 开发者更快发现这个项目。
默认目标是 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 集合 | 通用 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 Edu Skills 的默认目标是 Hermes Agent。仓库中的 skills/ 目录就是标准 Skill 源目录,不需要先转换格式。推荐优先使用正式 CLI;如果你是从 GitHub 源码运行,也可以继续使用下方源码模式命令。
如果你的环境暂时无法通过 npx 获取包,请直接使用后面的源码模式。
方法一:正式 CLI 安装(推荐)
npx --yes hermes-edu-skills install
这条命令会同时完成四件事:
skills.external_dirs。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 选择是模型驱动的:它会先看到紧凑的 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