---
name: "Flashcard Tutor"
description: "User wants to create flashcards, study with flashcards, or review material.
Triggers: \"make flashcards\", \"create flashcards from\", \"let's study\",
\"review my flashcards\", \"quiz me\", \"help me memorize\", \"spaced repetition\"
"
---
Turn anything into a study session. Paste notes, articles, or any content and get
smart flashcards generated automatically—no manual card-by-card entry.
Review with spaced repetition: cards you know well fade into the background while
tricky ones keep coming back until they stick. The tutor evaluates your answers
semantically, so you don't need word-for-word recall—just show you understand the concept.
Build multiple decks, track your progress, and study at your own pace. Cards you miss
come back tomorrow; cards you nail wait longer before their next appearance.
**Limitations:** Currently supports text content only. PDF/URL import coming later.
No Anki/Quizlet import yet.
## Tasks
These are tasks you can execute. Read the task file to get your instructions:
**Create Flashcards**
When: User provides content and wants to create flashcards from it
Follow the instructions in: `skills/sauna/study.flashcards.tutor/references/recipes/study.flashcards.create.md`
**Review Flashcards**
When: User wants to review or study their flashcards
Follow the instructions in: `skills/sauna/study.flashcards.tutor/references/recipes/study.flashcards.review.md`
**Manage Flashcard Decks**
When: User wants to view, list, or delete their flashcard decks
Follow the instructions in: `skills/sauna/study.flashcards.tutor/references/recipes/study.flashcards.manage.md`
## UI
These are areas on the user's filesystem that you can read from and write to.
**Flashcard Decks**
When: Check existing decks and card progress
Use this file: `documents/flashcard-decks.json`
Usage Guide: Persistent storage for all flashcard decks with spaced repetition metadata. JSON structure with decks keyed by slug (lowercase, hyphenated name). Each deck contains: name, created date, source description, and cards array. Each card tracks: id, front, back, created, lastReviewed, nextReview, interval (days until next review), correctCount, incorrectCount. New cards start with interval=1. On correct: interval doubles. On incorrect: interval resets to 1. Don't store session/temporary review data here—only committed deck state.
**New Cards Session**
When: Temporary storage during card creation
Use this file: `session/flashcards-new-cards.json`
Usage Guide: Temporary storage for newly generated flashcards before they're saved to a permanent deck. Contains deckName, sourceDescription, and cards array. Written by inference after generating cards, read by code:study.flashcards.save. Ephemeral—deleted after the creation task completes.
**Due Cards Session**
When: Temporary storage for due cards during review
Use this file: `session/flashcards-due-cards.json`
Usage Guide: Temporary storage for cards due for review today. Contains summary and cards array with id, deckSlug, deckName, front, back, interval, and stats. Written by code:study.flashcards.load, read by inference during review. Ephemeral—deleted after the review task completes.
**Review Results Session**
When: Temporary storage for review results
Use this file: `session/flashcards-review-results.json`
Usage Guide: Temporary storage for review session outcomes before updating deck SRS data. Contains array of results with cardId, deckSlug, and correct boolean. Written by inference during review, read by code:study.flashcards.update. Ephemeral—deleted after the review task completes.
## Knowledge
This is knowledge you have access to. Read these files if you need additional context:
**Flashcard Creation Guide**
When: Reference for flashcard generation approach
Read the documentation in: `skills/sauna/study.flashcards.tutor/references/study.flashcards.creation.md`
**Flashcard Review Guide**
When: Reference for conducting review sessions
Read the documentation in: `skills/sauna/study.flashcards.tutor/references/study.flashcards.review.md`
