Hermes Edu Skills

面向中国教育场景的开源 Agent Skill Pack：教材同步、备考复习、拍照答疑、错题复盘、亲子陪学、阅读写作和教师工具，Hermes Agent 可直接使用，也可导出到 OpenClaw、Codex、Cursor、Claude Code 等 AI 工具。

A China-focused open education Agent Skill Pack for textbook sync, exam prep, photo Q&A, mistake review, family learning, reading/writing, and teacher workflows. Built for Hermes Agent, exportable to OpenClaw, Codex, Cursor, Claude Code, and other AI tools.

English · Skill Catalog · Discovery Index · Shineway

Hermes Edu Skills 是一套可直接被 Hermes Agent 识别的中文教育 Agent Skill Pack。它把教材同步、考试备考、拍照答疑、错题复盘、每日练习、阅读写作、亲子陪学、教师备课和家校沟通，整理成 170 个可浏览、可安装、可二次开发的产品级 Skill。

当前包含 170 个可直接安装使用的 Hermes Skill。它不是泛泛的 Prompt 合集，而是一套围绕“真实教育任务”组织的 Agent 能力目录：每个 Skill 都有触发信号、适用角色、参数维度、使用边界和 Hermes 可读取的 SKILL.md。

如果你正在做 AI 学习助手、AI 老师、教研工具、家长陪学产品、题库/错题产品，或想给 Hermes Agent 装上一套开箱即用的中文教育能力，这个仓库可以直接作为起点。觉得有帮助的话，欢迎 Star，它会帮助更多中文教育 AI 开发者更快找到这个项目。

导航

• 30 秒理解
• 默认使用：Hermes Agent
• 只安装单个 Skill
• 导出给其它 AI 工具或 Agent
• 按角色选择
• 技能分类总览
• 全部 Skill 列表
• 参与贡献
• 路线图

30 秒理解

为什么值得关注

• 中国教育场景优先：教材版本、年级册别、单元课时、同步练习、错题巩固、备考复习、亲子陪学都是一等公民。
• 产品级分类：不按技术文件夹堆砌，而按用户真正要完成的任务组织，拿来就能做教育 Agent 原型。
• 兼容 Hermes Agent：每个 Skill 都是标准 SKILL.md，可被 Hermes 直接识别。
• 可读、可改、可扩展：既能直接安装，也能作为教育 Agent Skill 设计参考和商业产品能力清单。
• 传播友好：每个精品 Skill 都写清“解决什么问题、适合谁、怎么用、输出什么、不能做什么”。
• 公开友好：仓库只包含公开 Skill 文档、索引和校验工具，不包含用户数据、密钥或商业后端实现。

你可以用它做什么

• 给本地 Hermes Agent 增加一套中文教育 Skill 库，让 Agent 会做教材同步、备考、阅读写作和陪学。
• 快速搭建 AI 学习助手、AI 老师、AI 助教、拍照答疑、错题复盘、亲子阅读、作文批改等教育 Agent 原型。
• 学习和复用教育 Skill 的目录结构、触发信号、适用场景和工作流命名方式。
• 为学校、老师、家长、教培机构和成人学习场景设计自己的 Skill。
• Fork 后可以继续扩展教材版本、知识点覆盖和独立 Hermes 工具适配。

按角色选择

发起与维护

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

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

项目亮点

• 170 个可点击浏览的产品级 SKILL.md。
• 分类围绕用户任务组织：教材同步、学习核心、每日练习、考试备考、阅读写作、教师工具、家庭教育。
• 每个 Skill 都包含 Hermes frontmatter、适用场景、调用信号和工作流名称。
• 新增 Skill 独立使用标记和安装选择器列，同时标出正式 CLI 与源码模式应该复制的名字。
• 年级、册别、单元、课时、知识点和难度作为参数传入，不再拆成海量独立 Skill。
• 自带 catalog.json 和 .well-known/skills/index.json，方便工具读取和二次集成。
• 自带校验脚本，确保目录、索引和 Skill 文件一致。
• MIT 协议，适合个人学习、二次开发和教育 Agent 原型建设。

如何支持这个项目

• 点 Star：帮助更多人发现这个教育 Skill Pack。
• Watch：关注后续新增 Skill、安装方式和 Hermes 适配更新。
• Fork：把 skills/ 接入你自己的 Hermes Agent 或教育 Agent 项目。
• 提 Issue：告诉我们你最需要的年级、教材版本、学科或教师工具。
• 提 PR：贡献新的 Skill、优化中文指令、补充使用示例。

默认使用：Hermes Agent

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

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

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

npx hermes-edu-skills install hermes --config ~/.hermes/config.yaml

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

npx hermes-edu-skills install hermes textbook-sync --config ~/.hermes/config.yaml
npx hermes-edu-skills install hermes 教材同步 --config ~/.hermes/config.yaml

只安装一个 Skill 到 Hermes Agent：

npx hermes-edu-skills install hermes agent-study-plan --config ~/.hermes/config.yaml

先浏览和搜索：

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

方法二：源码模式安装（从 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 的 Skill 工具验证：

from tools.skills_tool import skills_list, skill_view

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

只安装单个 Skill

很多用户第一次只想试一个能力，不需要把完整 Skill Pack 全部安装。正式 CLI 支持把 Skill 名直接放在工具名后面；高级模式仍支持 --skill ，可以多次传入，也可以用逗号分隔。

一次安装多个 Skill：

npx hermes-edu-skills install openclaw agent-study-plan,agent-mistake-review

如果不确定 slug，可以先搜索：

npx hermes-edu-skills search 学习计划
npx hermes-edu-skills info agent-study-plan

导出给其它 AI 工具或 Agent

如果你使用的不是 Hermes Agent，也可以把这套 Skill Pack 转成其它工具更容易识别的目录结构。核心原则是：skills/ 保持 Hermes 原生格式，agent-pack 负责复制、扁平化或生成目标工具规则。

只转换 OpenClaw 格式，不安装到默认目录：

npx hermes-edu-skills export openclaw

只导出某一个分类，例如教材同步。分类名旁边会标出两种安装选择器；也可以直接传入中文别名，例如 教材同步：

npx hermes-edu-skills export openclaw textbook-sync
npx hermes-edu-skills export openclaw 教材同步

常用分类安装选择器：

源码模式和高级写法仍然可用，适合需要动态指定工具或目标目录的集成场景：

npm run agent:install -- --tool hermes --skill agent-study-plan --config ~/.hermes/config.yaml
npm run agent:convert -- --tool openclaw --category 教材同步 --target ./dist/textbook-sync-skills

旧命令仍可使用，兼容早期文档：

npm run install:hermes
npm run install:openclaw
npm run export:agents

技能分类总览

先从这些一级分类进入。每个分类下面仍保留完整可点击 Skill 表格，方便浏览、检索和二次集成。

覆盖范围

全部 Skill 列表

下面的表格列出了当前全部 170 个公开 Skill。中文 README 的分类列和 Skill 列都优先展示可复制的英文选择器，下一行保留中文名称；旁边的“安装选择器”列同时标出正式 CLI 与源码模式该复制的参数。

教材同步Textbook Sync

面向中国教材版本、年级、册别、单元、课时和知识点的同步学习能力。年级、册别、单元和难度作为参数传入，不再拆成大量独立 Skill。

安装选择器：npx: textbook-syncnpm: --category textbook-sync

学习核心能力Learning Core

学习计划、拍照答疑、错题复盘、学情报告等通用学习闭环能力。

安装选择器：npx: learning-corenpm: --category learning-core

每日练习Daily Practice

面向每天短时高频训练，例如口算、听写、背诵、词汇、快速巩固。

安装选择器：npx: daily-practicenpm: --category daily-practice

阅读写作Reading & Writing

面向语文、英语、学术和职场表达的阅读与写作能力。

安装选择器：npx: reading-writingnpm: --category reading-writing

考试备考Exam Prep

面向期末、中考、高考、考研、四六级、考证和公务员等备考场景。

安装选择器：npx: exam-prepnpm: --category exam-prep

老师工具Teacher Tools

面向老师备课、作业生成、班级分析和家校沟通。

安装选择器：npx: teacher-toolsnpm: --category teacher-tools

家庭教育Family Education

面向家长陪伴、亲子阅读、作业习惯和家庭沟通。

安装选择器：npx: family-educationnpm: --category family-education

语言学习Language Learning

面向成人英语、出国考试、口语、听力和长期语言能力提升。

安装选择器：npx: language-learningnpm: --category language-learning

成人与职业学习Career Learning

面向大学、成人学习、职业技能和考证场景。

安装选择器：npx: career-learningnpm: --category career-learning

项目结构

hermes-edu-skills/
├─ .github/workflows/validate.yml
├─ .well-known/skills/index.json
├─ skills/
│  ├─ textbook-sync/
│  ├─ learning-core/
│  ├─ daily-practice/
│  ├─ exam-prep/
│  ├─ teacher-tools/
│  ├─ family-education/
│  └─ ...
├─ scripts/validate.mjs
├─ scripts/agent-pack.mjs
├─ catalog.json
├─ CHANGELOG.md
├─ CONTRIBUTING.md
├─ LICENSE
├─ README.md
├─ README.en.md
├─ RELEASE.md
└─ SECURITY.md

校验 Skill Pack

在独立包根目录：

npm run validate

校验内容包括：

• catalog.json 和 discovery index 名称。
• catalog.skillCount 是否等于实际 SKILL.md 数量。
• discovery index 是否和 catalog 对齐。
• frontmatter 中的 Skill 名称。
• source: hermes-edu-skills。
• author: zhongwei。

兼容说明

• Hermes Agent：推荐使用 npx hermes-edu-skills install hermes --config ~/.hermes/config.yaml 写入 skills.external_dirs。
• OpenClaw / Codex / Claude Code：推荐使用 npx hermes-edu-skills install 导出扁平目录，每个 Skill 都是 /SKILL.md。
• Cursor：推荐使用 npx hermes-edu-skills install cursor --workspace 生成 .cursor/rules/*.mdc 和本地 Skill Pack。
• 其它 Agent：推荐使用 npx hermes-edu-skills export generic --target ，再把导出的目录接入目标 Agent 的 Skill / prompt / tool registry。
• 每个 Skill 都是独立可读的 SKILL.md，可以直接用于学习、改造或接入自己的 Agent。
• 部分 Skill 中的 workflow 名称是建议接口，具体执行能力取决于你的 Hermes 工具集和运行环境。

路线图

• 增加更多 Agent Runtime 的导出适配器。
• 增加常见 Hermes / OpenClaw / Codex Agent 使用示例。
• 持续提升 Skill 质量等级和公开审核状态。
• 增加更多贴合教材/课程体系的知识点覆盖和参数示例。
• 增加可选工具适配器，让需要执行能力的 workflow 可以真正跑起来。
• 在 Hermes 公开 Skill Registry 规范稳定后，探索更便捷的安装方式。

参与贡献

欢迎贡献。请先阅读 CONTRIBUTING.md。

适合贡献的内容包括：

• 改进某个 SKILL.md 的指令。
• 增加新的教育 Skill。
• 改进校验脚本。
• 增加独立 Hermes 用户示例。
• 改进中英文文档。

开源协议

MIT，见 LICENSE。