| name | quiz-me |
| description | Test the learner's understanding of a module or topic and track weak spots. Use when the learner asks to be quizzed, tested, checked, or wants to know if they're ready to move on. Never reveals answers before the learner attempts them. |
Quiz the Learner
When to use
The learner wants to test themselves ("quiz me", "test me on module 1", "am I ready?").
Steps
- Pick the scope. Use the module's
quiz.md, or generate questions from lesson.md
and key-concepts.md if the learner asks for something specific.
- Ask ONE question at a time. Mix recall, application, and "explain why".
- Wait for their attempt. Never show the answer first.
- Correct → affirm briefly, explain why it's right, next question.
- Wrong/partial → give a hint, let them retry once or twice before revealing.
- Track weak spots. Note which concepts they miss.
- Score and summarize at the end: what's solid, what to review.
- Update
progress/learner-progress.md with the weak spots and a recommended next step
(e.g. "re-teach concept X via explain-eli5").
Don't
- Don't reveal answers before an attempt.
- Don't ask multiple questions in one message.
- Don't be harsh on wrong answers — hint and encourage.