Lesson Quiz

Lesson Quiz

Interactive quiz that tests understanding of a specific Hermes Agent module with 8 questions, provides per-question feedback, and identifies areas to review.

Instructions

Step 1: Determine the Lesson

If the user provided a lesson as an argument (e.g., /lesson-quiz memory or /lesson-quiz 02), map it to the lesson directory:

Topic slug mapping:

| Slug | Module | Description | |------|--------|-------------| | quickstart | 01-quickstart | Getting started with Hermes Agent | | memory | 02-memory | Persistent context and memory management | | skills | 03-skills | Reusable capabilities and skill configuration | | delegation | 04-delegation | Task delegation and subagents | | mcp | 05-mcp | MCP server integration | | voice | 06-voice | Voice interaction mode | | messaging | 07-messaging-gateway | Messaging platform integrations | | cron | 08-cron | Scheduled tasks and automation | | soul-personality | 09-soul-personality | Personality configuration | | toolsets | 10-toolsets | Tool collections | | plugins | 11-plugins | Plugin system | | checkpoints | 12-checkpoints | Session snapshots and recovery | | providers | 13-providers | AI provider configuration | | context-refs | 14-context-refs | Context reference syntax |

Number mapping:

| Number | Slug | |--------|------| | 01 | quickstart | | 02 | memory | | 03 | skills | | 04 | delegation | | 05 | mcp | | 06 | voice | | 07 | messaging | | 08 | cron | | 09 | soul-personality | | 10 | toolsets | | 11 | plugins | | 12 | checkpoints | | 13 | providers | | 14 | context-refs |

If no argument was provided, present a selection prompt using natural language:

可用的 quiz topic：

  01 · quickstart        07 · messaging
  02 · memory           08 · cron
  03 · skills           09 · soul-personality
  04 · delegation       10 · toolsets
  05 · mcp              11 · plugins
  06 · voice            12 · checkpoints
                          13 · providers
                          14 · context-refs

请输入 topic 名称或编号（例如：memory, 02, mcp）。

Fallback logic (if input cannot be recognized):

无法识别的输入。请输入有效的 topic 名称或编号。

可用的 topic：quickstart, memory, skills, delegation, mcp, voice, messaging, cron, soul-personality, toolsets, plugins, checkpoints, providers, context-refs

---

Step 2: Read the Quiz Content

Read the YAML file for the selected topic:

• Path: .claude/skills/lesson-quiz/topics/{topic}.yaml

Parse the questions and prepare for presentation.

---

Step 3: Present the Quiz

Present 8 questions in 4 rounds (2 questions per round). For each question:

1. Read the question text and 4 options clearly
2. Wait for the user's answer (A, B, C, or D)
3. Immediately show whether the answer was correct or incorrect
4. Provide the explanation from the question bank

Question format:

--- 第 N 题（共 8 题）---

[category: 概念理解 / 实践应用]

问题：[question text]

A. [option A]
B. [option B]
C. [option C]
D. [option D]

请输入你的答案（A/B/C/D）：

After each answer:

✅ 正确！[explanation]

或

❌ 错误。正确答案是 [correct_answer]。
[explanation]

---

Step 4: Score and Present Results

After all 8 questions, calculate the score and present final results.

Scoring:

• Each correct answer = 1 point
• Total possible = 8 points

Grade scale:

• 7-8: Mastered — Excellent understanding
• 5-6: Partial — Good grasp, review recommended
• 0-4: Review Needed — Significant gaps

Final results format:

## 📊 测验结果：[topic]

**得分：X / 8**

| 题号 | 类别 | 题目摘要 | 你的答案 | 结果 |
|------|------|---------|---------|------|
| 1 | 概念 | [short question] | [A/B/C/D] | ✅/❌ |
| 2 | 实践 | [short question] | [A/B/C/D] | ✅/❌ |
| ... | ... | ... | ... | ... |

**等级：[Mastered / Partial / Review Needed]**

---

### Recommended Next Steps

[Based on score:]

**如果 Mastered (7-8)：**
恭喜！你已掌握这个模块。可以继续学习下一个模块。

**如果 Partial (5-6)：**
建议复习以下题目后再试：
- Q[X]: [topic of weak question]
- Q[Y]: [topic of weak question]

**如果 Review Needed (0-4)：**
建议重新学习本模块的以下章节：
- [link to relevant README section]

---

Step 5: Offer Follow-up

After presenting results, ask:

"接下来你想做什么？"

• A: "重新测验" — Retake the same quiz
• B: "测验另一个 topic" — Go back to Step 1 for topic selection
• C: "继续学习" — Suggest continuing to the next module in the learning path

If A: Restart the quiz with the same topic (skip topic selection). If B: Go back to Step 1. If C: Recommend the next module based on the learning path.

---

Error Handling

Invalid topic argument

Show the full topic list and ask for a valid selection.

User wants to quit mid-quiz

Present partial results for answered questions only. Offer to resume later.

Invalid answer format

Prompt again: "请输入 A、B、C 或 D。"

YAML file not found

Error message: "找不到该 topic 的测验文件。请检查 topic 名称是否正确。"

Topic Files Reference

| Topic | File Path | |-------|-----------| | quickstart | topics/quickstart.yaml | | memory | topics/memory.yaml | | skills | topics/skills.yaml | | delegation | topics/delegation.yaml | | mcp | topics/mcp.yaml | | voice | topics/voice.yaml | | messaging | topics/messaging.yaml | | cron | topics/cron.yaml | | soul-personality | topics/soul-personality.yaml | | toolsets | topics/toolsets.yaml | | plugins | topics/plugins.yaml | | checkpoints | topics/checkpoints.yaml | | providers | topics/providers.yaml | | context-refs | topics/context-refs.yaml |

Validation

Triggering phrases:

• "quiz me on [topic]"
• "lesson quiz"
• "test my knowledge of [topic]"
• "practice quiz"
• "/lesson-quiz [topic]"
• "how well do I know [topic]"
• "do I understand [topic]"

NOT triggering:

• "assess my level" (use /self-assessment instead)
• "explain [topic] to me"
• "help me with [topic]"
• "teach me [topic]"

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: 1234567mm
• Source: 1234567mm/hermes-howto
• License: MIT

Install and usage instructions live in the source repository linked above.