| name | lesson-quiz |
| version | 2.0.0 |
| description | Test your knowledge of a specific Hermes Agent topic with an interactive quiz. Trigger when: user runs /lesson-quiz, asks to quiz on a topic, wants to test understanding, or says "quiz me on [topic]". DO NOT trigger for general questions about Hermes features.
|
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:
- Read the question text and 4 options clearly
- Wait for the user's answer (A, B, C, or D)
- Immediately show whether the answer was correct or incorrect
- 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]"
