| name | learn-quiz |
| description | Generate open-ended quiz questions from facts in a specific deck (or all facts). Read-only — does NOT update SM-2 state or review-log. Use when the user says "quiz", "test me", "pratique", "/learn-quiz", or wants to practice without triggering a formal review. |
Learn Quiz
Generates open-ended practice questions from facts in workspace/learning/facts/. This is a read-only exercise — no frontmatter is modified, no log entries are written.
Trigger
User wants to practice recall without formally reviewing (e.g., "me teste sobre claude-skills", "/learn-quiz", "quiz geral").
Workflow
Step 1 — Identify scope
Parse the user's request for a deck name:
/learn-quiz {deck-name} → filter facts where deck == deck-name/learn-quiz (no argument) → use all facts in workspace/learning/facts/
If no facts are found for the specified deck:
"Nenhum fato encontrado no deck '{deck}'. Verifique o nome do deck ou use /learn-stats para ver os decks ativos."
If workspace/learning/facts/ is empty or doesn't exist:
"Nenhum fato encontrado. Use /learn-capture para adicionar fatos primeiro."
Step 2 — Select facts
From the matching facts, select up to 5 to quiz on. Prefer:
- Facts not recently reviewed (older
next_review)
- Random otherwise
Step 3 — Generate questions
For each selected fact, generate one open-ended question derived from the Retrieval Q field. You may rephrase the original question slightly for variety, but the answer must still be the Fact content.
Rules for questions:
- Open-ended only (no multiple choice, no true/false)
- In pt-BR
- Must be answerable from memory without the source text
Step 4 — Run the quiz interactively
For each question (up to 5):
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🧪 Quiz — {deck} | Pergunta {current}/{total}
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
{question}
Wait for the user's answer. Then show:
✅ Resposta de referência:
{Fact content}
{Brief feedback: correct elements the user got right, what they missed — 1-2 sentences}
Do NOT score formally. This is practice, not review.
Step 5 — End of quiz
After all questions:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🏁 Quiz concluído! {N} perguntas praticadas.
💡 Para revisão formal com SM-2, use /learn-review
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Constraints
- NEVER modify any file. This skill is 100% read-only.
- NEVER write to review-log.jsonl.
- NEVER update frontmatter of any fact file.
- Max 5 questions per session.
- If the user asks to save a score or grade — decline: "O quiz não atualiza o estado SM-2. Use /learn-review para revisão formal."
