/learn-quiz

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: 1. Facts not recently reviewed (older `next_review`) 2. 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."