# Learn Quiz

> 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.

- Skill: `evolution-foundation/learn-quiz` (Agent Skill)
- Install (CLI): `npx skillmds@latest add evolution-foundation/learn-quiz`
- Raw SKILL.md: https://api.skillmd.com/api/skills/evolution-foundation/learn-quiz/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: evolution-foundation (https://skillmd.com/u/evolution-foundation)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/evolution-foundation/learn-quiz

---


# 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."