hermes-edu-skills

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

hermes-edu-skills

hermes-edu-skills

Skill by ara.so — Hermes Skills collection.
ara.so开发的Skill——Hermes Skills合集。

Overview

概述

hermes-edu-skills
is an open-source Agent Skill Pack providing 170 structured education capabilities aligned with China's K-12 curriculum. It enables Hermes Agent and other AI tools to understand Chinese textbook versions (人教, 统编, 北师大, 苏教, etc.), grade levels, units, exam systems, and real education workflows.
Unlike prompt collections, each skill is a structured
SKILL.md
with triggers, roles, parameters, boundaries, and standard metadata. Skills cover:
  • Textbook sync (41 skills): Grade/unit/lesson-aligned exercises and explanations
  • Learning core (15 skills): Study plans, photo Q&A, mistake review, learning reports
  • Daily practice (28 skills): Mental math, dictation, recitation, vocabulary drills
  • Reading & writing (10 skills): Chinese/English composition, academic writing
  • Exam prep (27 skills): Midterm, high school entrance, college entrance, certification exams
  • Teacher tools (31 skills): Lesson prep, assignment generation, class analysis
  • Family education (8 skills): Parent-child learning, reading habits, homework support
  • Language learning (3 skills): Adult English, IELTS/TOEFL, oral practice
  • Career learning (7 skills): University, certification, professional development
The project is maintained by Shineway Technology and released under MIT license.
hermes-edu-skills
是一个开源的Agent Skill包,提供170项符合中国K-12课程体系的结构化教育能力。它能让Hermes Agent及其他AI工具理解国内教材版本(人教、统编、北师大、苏教等)、年级、单元、考试体系以及真实教育工作流。
与普通提示词合集不同,每个技能都是一个结构化的
SKILL.md
文件,包含触发词、角色、参数、边界和标准元数据。技能覆盖以下领域:
  • 教材同步(41项技能):与年级/单元/课时匹配的习题及讲解
  • 学习核心(15项技能):学习计划、拍照答疑、错题分析、学习报告
  • 日常练习(28项技能):口算、听写、背诵、词汇训练
  • 读写能力(10项技能):中英文写作、学术写作
  • 备考复习(27项技能):期中、中考、高考、资格证考试
  • 教师工具(31项技能):备课、作业生成、班级分析
  • 家庭教育(8项技能):亲子学习、阅读习惯培养、作业辅导
  • 语言学习(3项技能):成人英语、雅思/托福、口语练习
  • 职业学习(7项技能):大学规划、资格认证、职业发展
本项目由Shineway Technology维护,基于MIT许可证发布。

Installation

安装

Install CLI globally or via npx

全局安装CLI或通过npx使用

bash
undefined
bash
undefined

Use npx (recommended - no install needed)

使用npx(推荐 - 无需安装)

npx hermes-edu-skills --version
npx hermes-edu-skills --version

Or install globally

或全局安装

npm install -g hermes-edu-skills
undefined
npm install -g hermes-edu-skills
undefined

Install all 170 skills into Hermes Agent

将全部170项技能安装到Hermes Agent

bash
undefined
bash
undefined

Default: installs all skills + generates HERMES.md prompt

默认:安装所有技能 + 生成HERMES.md提示词

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

Install without generating prompt

安装时不生成提示词

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

Force overwrite existing HERMES.md

强制覆盖已有的HERMES.md

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

This command:
1. Adds `skills/` directory to Hermes `skills.external_dirs` in config
2. Generates `HERMES.md` in current directory with project-level prompt
3. Makes all 170 skills discoverable by Hermes
npx hermes-edu-skills install hermes --config ~/.hermes/config.yaml --overwrite-prompt

该命令会执行以下操作:
1. 在配置文件的Hermes `skills.external_dirs`中添加`skills/`目录
2. 在当前目录生成包含项目级提示词的`HERMES.md`文件
3. 让Hermes能够发现全部170项技能

Install by category

按分类安装

bash
undefined
bash
undefined

Install textbook sync category (41 skills)

安装教材同步分类(41项技能)

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

Install learning core category (15 skills)

安装学习核心分类(15项技能)

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

Install exam prep category (27 skills)

安装备考复习分类(27项技能)

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

Chinese category names also supported

也支持中文分类名称

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

Category-specific install generates scoped `HERMES.md` prompting Hermes to search only that category.
npx hermes-edu-skills install hermes 教材同步 --config ~/.hermes/config.yaml

按分类安装会生成限定范围的`HERMES.md`,引导Hermes仅搜索该分类下的技能。

Install single skill

安装单个技能

bash
undefined
bash
undefined

Install only study plan skill

仅安装学习计划技能

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

Install mistake review skill

安装错题分析技能

npx hermes-edu-skills install hermes agent-mistake-review --config ~/.hermes/config.yaml

Single skill install generates `HERMES.md` scoped to that skill's triggers.
npx hermes-edu-skills install hermes agent-mistake-review --config ~/.hermes/config.yaml

安装单个技能会生成限定该技能触发词范围的`HERMES.md`。

Key Commands

核心命令

Search and discovery

搜索与发现

bash
undefined
bash
undefined

Search skills by keyword

按关键词搜索技能

npx hermes-edu-skills search 错题 npx hermes-edu-skills search textbook npx hermes-edu-skills search exam
npx hermes-edu-skills search 错题 npx hermes-edu-skills search textbook npx hermes-edu-skills search exam

Get detailed info about a skill

获取技能详细信息

npx hermes-edu-skills info agent-mistake-review npx hermes-edu-skills info textbook-exercise-generator
npx hermes-edu-skills info agent-mistake-review npx hermes-edu-skills info textbook-exercise-generator

List all categories

列出所有分类

npx hermes-edu-skills list categories
npx hermes-edu-skills list categories

List skills in a category

列出指定分类下的技能

npx hermes-edu-skills list textbook-sync
undefined
npx hermes-edu-skills list textbook-sync
undefined

Interactive query with skill routing

带技能路由的交互式查询

bash
undefined
bash
undefined

Ask a question - shows matched skills then calls Hermes

提出问题 - 显示匹配的技能后调用Hermes

npx hermes-edu-skills ask "帮我出5道八年级下册物理力学选择题"
npx hermes-edu-skills ask "帮我出5道八年级下册物理力学选择题"

The command will:

该命令会:

1. Search relevant skills (e.g. textbook-exercise-generator)

1. 搜索相关技能(例如textbook-exercise-generator)

2. Display matched skills

2. 展示匹配到的技能

3. Route to Hermes with skill context

3. 携带技能上下文路由到Hermes

undefined
undefined

Generate project prompt

生成项目提示词

bash
undefined
bash
undefined

View full HERMES.md prompt content

查看完整的HERMES.md提示词内容

npx hermes-edu-skills prompt
npx hermes-edu-skills prompt

Save to file

保存到文件

npx hermes-edu-skills prompt > HERMES.md
npx hermes-edu-skills prompt > HERMES.md

Generate prompt for specific category

生成指定分类的提示词

npx hermes-edu-skills prompt --category textbook-sync > HERMES_TEXTBOOK.md
undefined
npx hermes-edu-skills prompt --category textbook-sync > HERMES_TEXTBOOK.md
undefined

Diagnostics

诊断

bash
undefined
bash
undefined

Check installation status, version, config, Hermes visibility

检查安装状态、版本、配置、Hermes可见性

npx hermes-edu-skills doctor
npx hermes-edu-skills doctor

Output shows:

输出内容包括:

- Number of skills installed

- 已安装技能数量

- Categories available

可用分类

- Hermes config path and status

- Hermes配置路径及状态

- HERMES.md existence

- HERMES.md是否存在

- Version info

- 版本信息

undefined
undefined

Export to Other AI Tools

导出到其他AI工具

Export to Cursor

导出到Cursor

bash
undefined
bash
undefined

Install to Cursor workspace

安装到Cursor工作区

npx hermes-edu-skills install cursor --workspace /path/to/project
npx hermes-edu-skills install cursor --workspace /path/to/project

Installs to /path/to/project/.cursor/skills/

安装路径为/path/to/project/.cursor/skills/

undefined
undefined

Export to OpenClaw

导出到OpenClaw

bash
npx hermes-edu-skills install openclaw
bash
npx hermes-edu-skills install openclaw

Installs to ~/.openclaw/skills/hermes-edu-skills/

安装路径为~/.openclaw/skills/hermes-edu-skills/

undefined
undefined

Export to Codex

导出到Codex

bash
npx hermes-edu-skills install codex
bash
npx hermes-edu-skills install codex

Installs to ~/.codex/skills/hermes-edu-skills/

安装路径为~/.codex/skills/hermes-edu-skills/

undefined
undefined

Export to Claude

导出到Claude

bash
npx hermes-edu-skills install claude
bash
npx hermes-edu-skills install claude

Installs to ~/.claude/skills/hermes-edu-skills/

安装路径为~/.claude/skills/hermes-edu-skills/

undefined
undefined

Generic export

通用导出

bash
undefined
bash
undefined

Export all skills to custom directory

将所有技能导出到自定义目录

npx hermes-edu-skills export generic --target ./dist/agent-skills
npx hermes-edu-skills export generic --target ./dist/agent-skills

Export single category

导出单个分类

npx hermes-edu-skills export generic --target ./dist/textbook --category textbook-sync
undefined
npx hermes-edu-skills export generic --target ./dist/textbook --category textbook-sync
undefined

Configuration

配置

Hermes config.yaml structure

Hermes config.yaml结构

The installer modifies
~/.hermes/config.yaml
(or custom path via
--config
):
yaml
skills:
  dirs:
    - ~/.hermes/skills
  external_dirs:
    - /path/to/hermes-edu-skills/skills  # Added by installer
  
  discovery:
    enabled: true
    auto_load: true
安装器会修改
~/.hermes/config.yaml
(或通过
--config
指定的自定义路径):
yaml
skills:
  dirs:
    - ~/.hermes/skills
  external_dirs:
    - /path/to/hermes-edu-skills/skills  # 由安装器添加
  
  discovery:
    enabled: true
    auto_load: true

Environment variables

环境变量

bash
undefined
bash
undefined

Override default Hermes config path

覆盖默认的Hermes配置路径

export HERMES_CONFIG_PATH=~/custom/hermes/config.yaml
export HERMES_CONFIG_PATH=~/custom/hermes/config.yaml

Use custom install location

使用自定义安装位置

export HERMES_EDU_SKILLS_PATH=~/my-skills/hermes-edu
undefined
export HERMES_EDU_SKILLS_PATH=~/my-skills/hermes-edu
undefined

Real Usage Examples

实际使用示例

Example 1: Textbook-aligned exercise generation

示例1:匹配教材的习题生成

After installing
textbook-sync
category:
javascript
// In Hermes Agent session or via API
const request = {
  skill: 'textbook-exercise-generator',
  params: {
    subject: '物理',
    grade: '八年级',
    semester: '下册',
    textbook_version: '人教版',
    unit: '第七单元:力',
    exercise_type: '选择题',
    difficulty: '中等',
    quantity: 5
  }
};

// Hermes routes to skill and returns structured exercises
User query that triggers this:
"帮我出5道八年级下册物理力学选择题,人教版"
安装
textbook-sync
分类后:
javascript
// 在Hermes Agent会话或通过API调用
const request = {
  skill: 'textbook-exercise-generator',
  params: {
    subject: '物理',
    grade: '八年级',
    semester: '下册',
    textbook_version: '人教版',
    unit: '第七单元:力',
    exercise_type: '选择题',
    difficulty: '中等',
    quantity: 5
  }
};

// Hermes会路由到对应技能并返回结构化习题
触发该技能的用户查询:
"帮我出5道八年级下册物理力学选择题,人教版"

Example 2: Mistake review workflow

示例2:错题分析工作流

After installing
agent-mistake-review
skill:
javascript
// User uploads photo of wrong problem
const mistakeReview = {
  skill: 'agent-mistake-review',
  input: {
    image: 'data:image/jpeg;base64,...',
    subject: '数学',
    grade: '九年级'
  }
};

// Skill returns:
// 1. Original problem transcription
// 2. Student's wrong answer analysis
// 3. Correct solution step-by-step
// 4. Knowledge point summary
// 5. Similar practice problems (3-5)
User query:
"这道题我做错了,帮我分析一下" [with image]
安装
agent-mistake-review
技能后:
javascript
// 用户上传错题照片
const mistakeReview = {
  skill: 'agent-mistake-review',
  input: {
    image: 'data:image/jpeg;base64,...',
    subject: '数学',
    grade: '九年级'
  }
};

// 技能返回内容包括:
// 1. 原题转录
// 2. 学生错误答案分析
// 3. 分步正确解法
// 4. 知识点总结
// 5. 类似练习题(3-5道)
用户查询:
"这道题我做错了,帮我分析一下" [附带图片]

Example 3: Daily math drill

示例3:每日数学练习

After installing
daily-practice
category:
javascript
// Generate daily mental math practice
const dailyDrill = {
  skill: 'daily-mental-math',
  params: {
    grade: '三年级',
    operation_types: ['加法', '减法'],
    difficulty: '基础',
    quantity: 20,
    time_limit_minutes: 5
  }
};

// Returns 20 problems with timer and auto-grading
User query:
"给我三年级的口算练习,20道题,加减法"
安装
daily-practice
分类后:
javascript
// 生成每日口算练习
const dailyDrill = {
  skill: 'daily-mental-math',
  params: {
    grade: '三年级',
    operation_types: ['加法', '减法'],
    difficulty: '基础',
    quantity: 20,
    time_limit_minutes: 5
  }
};

// 返回20道习题,包含计时器和自动批改功能
用户查询:
"给我三年级的口算练习,20道题,加减法"

Example 4: Teacher lesson prep

示例4:教师备课

After installing
teacher-tools
category:
javascript
// Generate lesson plan
const lessonPrep = {
  skill: 'teacher-lesson-planner',
  params: {
    subject: '语文',
    grade: '五年级',
    semester: '上册',
    textbook_version: '统编版',
    lesson: '第15课:桂花雨',
    class_duration: 40,
    teaching_goals: ['理解课文内容', '感受思乡情感', '学习生字词']
  }
};

// Returns:
// - Teaching objectives
// - Key/difficult points
// - Teaching process (导入-新授-练习-总结)
// - Classroom activities
// - Homework assignment
User query:
"帮我备课,五年级语文统编版第15课桂花雨,一节课40分钟"
安装
teacher-tools
分类后:
javascript
// 生成教案
const lessonPrep = {
  skill: 'teacher-lesson-planner',
  params: {
    subject: '语文',
    grade: '五年级',
    semester: '上册',
    textbook_version: '统编版',
    lesson: '第15课:桂花雨',
    class_duration: 40,
    teaching_goals: ['理解课文内容', '感受思乡情感', '学习生字词']
  }
};

// 返回内容包括:
// - 教学目标
// - 重难点
// - 教学流程(导入-新授-练习-总结)
// - 课堂活动
// - 作业布置
用户查询:
"帮我备课,五年级语文统编版第15课桂花雨,一节课40分钟"

Example 5: Exam prep study plan

示例5:备考学习计划

After installing
exam-prep
category:
javascript
// Generate high school entrance exam prep plan
const examPlan = {
  skill: 'exam-prep-study-planner',
  params: {
    exam_type: '中考',
    subjects: ['数学', '物理', '化学'],
    current_level: '中等',
    target_score: '优秀',
    days_until_exam: 90,
    daily_study_hours: 2
  }
};

// Returns:
// - 90-day phased plan (基础-强化-冲刺)
// - Daily task breakdown by subject
// - Weekly mock exam schedule
// - Weak point focus areas
// - Progress tracking checkpoints
User query:
"距离中考还有90天,帮我制定数理化复习计划,每天2小时"
安装
exam-prep
分类后:
javascript
// 生成中考备考计划
const examPlan = {
  skill: 'exam-prep-study-planner',
  params: {
    exam_type: '中考',
    subjects: ['数学', '物理', '化学'],
    current_level: '中等',
    target_score: '优秀',
    days_until_exam: 90,
    daily_study_hours: 2
  }
};

// 返回内容包括:
// - 90天分阶段计划(基础-强化-冲刺)
// - 按科目拆分的每日任务
// - 每周模拟考试安排
// - 薄弱知识点聚焦
// - 进度跟踪检查点
用户查询:
"距离中考还有90天,帮我制定数理化复习计划,每天2小时"

Skill Structure

技能结构

Each skill is a
SKILL.md
file with:
markdown
---
id: skill-unique-id
name: Display Name
description: One-line description
category: textbook-sync
subcategory: exercise-generation
version: 1.0.0
author: Shineway
tags: [grade, subject, textbook]
triggers:
  - "natural phrase user might say"
  - "another trigger phrase"
parameters:
  - name: grade
    type: string
    required: true
    options: [一年级, 二年级, ..., 高三]
  - name: subject
    type: string
    required: true
roles: [student, teacher, parent]
complexity: medium
estimated_tokens: 500
---
每个技能都是一个
SKILL.md
文件,格式如下:
markdown
---
id: skill-unique-id
name: 显示名称
description: 一行描述
category: textbook-sync
subcategory: exercise-generation
version: 1.0.0
author: Shineway
tags: [grade, subject, textbook]
triggers:
  - "用户可能说的自然语句"
  - "另一个触发语句"
parameters:
  - name: grade
    type: string
    required: true
    options: [一年级, 二年级, ..., 高三]
  - name: subject
    type: string
    required: true
roles: [student, teacher, parent]
complexity: medium
estimated_tokens: 500
---

Skill Content

技能内容

Detailed prompt and workflow...
undefined
详细提示词和工作流...
undefined

Common Patterns

通用模式

Pattern 1: Grade/semester parameter normalization

模式1:年级/学期参数标准化

Skills normalize Chinese grade expressions:
javascript
// All these map to same internal grade level:
"一年级上册" → grade: 1, semester: 1
"小学一年级第一学期" → grade: 1, semester: 1  
"1年级上" → grade: 1, semester: 1
技能会对中文年级表达进行标准化:
javascript
// 以下表达都会映射到相同的内部年级:
"一年级上册" → grade: 1, semester: 1
"小学一年级第一学期" → grade: 1, semester: 1  
"1年级上" → grade: 1, semester: 1

Pattern 2: Textbook version detection

模式2:教材版本识别

Skills recognize major Chinese textbook publishers:
  • 人教版 (People's Education Press)
  • 统编版 (National Unified Edition)
  • 北师大版 (Beijing Normal University)
  • 苏教版 (Jiangsu Education)
  • 鲁科版 (Shandong Science & Tech)
技能支持识别国内主流教材出版社:
  • 人教版 (People's Education Press)
  • 统编版 (National Unified Edition)
  • 北师大版 (Beijing Normal University)
  • 苏教版 (Jiangsu Education)
  • 鲁科版 (Shandong Science & Tech)

Pattern 3: Difficulty calibration

模式3:难度校准

Standard difficulty levels across skills:
  • 基础
    (basic): 60-70% students should master
  • 中等
    (medium): 40-50% students should master
  • 提高
    (advanced): 20-30% students should master
  • 拔高
    (olympiad): <10% students should master
所有技能采用统一的难度等级:
  • 基础
    (basic): 60-70%学生应掌握
  • 中等
    (medium): 40-50%学生应掌握
  • 提高
    (advanced): 20-30%学生应掌握
  • 拔高
    (olympiad): <10%学生应掌握

Pattern 4: Multi-skill workflow

模式4:多技能工作流

Complex tasks chain multiple skills:
javascript
// 1. Photo Q&A extracts problem
skill: 'agent-photo-qa'

// 2. Mistake review analyzes error  
skill: 'agent-mistake-review'

// 3. Exercise generator creates similar problems
skill: 'textbook-exercise-generator'

// 4. Daily practice adds to drill queue
skill: 'daily-practice-tracker'
复杂任务会串联多个技能:
javascript
// 1. 拍照答疑提取题目
skill: 'agent-photo-qa'

// 2. 错题分析错误原因  
skill: 'agent-mistake-review'

// 3. 习题生成器创建类似题目
skill: 'textbook-exercise-generator'

// 4. 日常练习添加到训练队列
skill: 'daily-practice-tracker'

Troubleshooting

故障排除

Skills not appearing in Hermes

技能未在Hermes中显示

Check config path:
bash
npx hermes-edu-skills doctor
检查配置路径:
bash
npx hermes-edu-skills doctor

Verify skills.external_dirs contains correct path

验证skills.external_dirs包含正确路径

cat ~/.hermes/config.yaml | grep external_dirs

**Manually add to config:**
```yaml
skills:
  external_dirs:
    - /absolute/path/to/hermes-edu-skills/skills
Restart Hermes:
bash
hermes restart
cat ~/.hermes/config.yaml | grep external_dirs

**手动添加到配置文件:**
```yaml
skills:
  external_dirs:
    - /absolute/path/to/hermes-edu-skills/skills
重启Hermes:
bash
hermes restart

Hermes not routing to education skills

Hermes未路由到教育类技能

Verify HERMES.md exists and is loaded:
bash
undefined
验证HERMES.md存在且已加载:
bash
undefined

Check current directory for HERMES.md

检查当前目录是否有HERMES.md

ls -la HERMES.md
ls -la HERMES.md

Regenerate if missing

若缺失则重新生成

npx hermes-edu-skills prompt > HERMES.md

**Check Hermes project prompt loading:**
```bash
npx hermes-edu-skills prompt > HERMES.md

**检查Hermes项目提示词加载情况:**
```bash

Hermes should load HERMES.md from project root

Hermes应从项目根目录加载HERMES.md

Or from config-specified project_prompt_path

或从配置文件指定的project_prompt_path路径加载


**Test with explicit skill mention:**
"使用 hermes-edu-skills 的 textbook-exercise-generator 技能出5道题"
undefined

**通过明确提及技能进行测试:**
"使用 hermes-edu-skills 的 textbook-exercise-generator 技能出5道题"
undefined

Search returns no results

搜索无结果

Update catalog:
bash
undefined
更新目录:
bash
undefined

Catalog is pre-built, but if modified locally:

目录为预构建,若本地修改则执行:

cd hermes-edu-skills/ node scripts/build-catalog.js

**Check skill ID spelling:**
```bash
cd hermes-edu-skills/ node scripts/build-catalog.js

**检查技能ID拼写:**
```bash

List all skill IDs

列出所有技能ID

npx hermes-edu-skills list all | grep "id:"
undefined
npx hermes-edu-skills list all | grep "id:"
undefined

Export fails for target platform

导出到目标平台失败

Check target directory permissions:
bash
undefined
检查目标目录权限:
bash
undefined

Cursor export

Cursor导出

ls -ld ~/.cursor/skills/ mkdir -p ~/.cursor/skills/ # if missing
ls -ld ~/.cursor/skills/ mkdir -p ~/.cursor/skills/ # 若目录不存在则创建

Generic export

通用导出

mkdir -p ./target/dir npx hermes-edu-skills export generic --target ./target/dir

**Use absolute paths:**
```bash
npx hermes-edu-skills install cursor --workspace $(pwd)/my-project
mkdir -p ./target/dir npx hermes-edu-skills export generic --target ./target/dir

**使用绝对路径:**
```bash
npx hermes-edu-skills install cursor --workspace $(pwd)/my-project

Development and Contribution

开发与贡献

Run from source

从源码运行

bash
git clone https://github.com/zhongweiv/hermes-edu-skills.git
cd hermes-edu-skills/
bash
git clone https://github.com/zhongweiv/hermes-edu-skills.git
cd hermes-edu-skills/

Install dependencies

安装依赖

npm install
npm install

Run CLI locally

本地运行CLI

npm run cli -- install hermes --config ~/.hermes/config.yaml
npm run cli -- install hermes --config ~/.hermes/config.yaml

Run tests

运行测试

npm test
npm test

Validate all skills

验证所有技能

npm run validate
undefined
npm run validate
undefined

Create new skill

创建新技能

  1. Copy template from
    skills/_template/SKILL.md
  2. Fill in YAML frontmatter and content
  3. Place in appropriate category directory:
    skills/<category>/<skill-id>/SKILL.md
  4. Run validation:
bash
npm run validate
  1. Update catalog:
bash
node scripts/build-catalog.js
  1. Test installation:
bash
npm run cli -- info your-new-skill-id
npm run cli -- install hermes your-new-skill-id --config ~/.hermes/config.yaml
  1. skills/_template/SKILL.md
    复制模板
  2. 填写YAML前置内容和技能正文
  3. 放置到对应分类目录:
    skills/<category>/<skill-id>/SKILL.md
  4. 运行验证:
bash
npm run validate
  1. 更新目录:
bash
node scripts/build-catalog.js
  1. 测试安装:
bash
npm run cli -- info your-new-skill-id
npm run cli -- install hermes your-new-skill-id --config ~/.hermes/config.yaml

Validation rules

验证规则

Skills must pass:
  • YAML frontmatter syntax
  • Required fields: id, name, description, category, triggers
  • Triggers: 6-8 natural phrases
  • Parameters: valid types (string, number, boolean, array, object)
  • File location:
    skills/<category>/<id>/SKILL.md
  • Unique ID across all skills
Run validator:
bash
npx hermes-edu-skills validate
技能必须通过以下验证:
  • YAML前置内容语法正确
  • 必填字段:id、name、description、category、triggers
  • 触发词:6-8条自然语句
  • 参数:类型有效(string、number、boolean、array、object)
  • 文件位置:
    skills/<category>/<id>/SKILL.md
  • 技能ID全局唯一
运行验证器:
bash
npx hermes-edu-skills validate

API Reference (if running as library)

API参考(作为库运行时)

javascript
import { HermesEduSkills } from 'hermes-edu-skills';

const skills = new HermesEduSkills();

// Search skills
const results = skills.search('错题复盘');

// Get skill metadata
const skill = skills.getSkill('agent-mistake-review');

// List categories
const categories = skills.listCategories();

// Install programmatically
await skills.install('hermes', {
  configPath: '~/.hermes/config.yaml',
  categories: ['textbook-sync'],
  generatePrompt: true
});
javascript
import { HermesEduSkills } from 'hermes-edu-skills';

const skills = new HermesEduSkills();

// 搜索技能
const results = skills.search('错题复盘');

// 获取技能元数据
const skill = skills.getSkill('agent-mistake-review');

// 列出分类
const categories = skills.listCategories();

// 程序化安装
await skills.install('hermes', {
  configPath: '~/.hermes/config.yaml',
  categories: ['textbook-sync'],
  generatePrompt: true
});

Resources

资源


This skill enables AI agents to help developers integrate China-focused education capabilities into Hermes Agent and other AI tools through structured, curriculum-aligned Agent Skills.

该技能使AI Agent能够帮助开发者通过结构化、贴合课程体系的Agent Skills,将面向中国的教育能力集成到Hermes Agent及其他AI工具中。