---
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`
## State
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 directory: `documents/knowledge/flashcards/*.md`
Usage Guide: Persistent storage for flashcard decks with spaced repetition metadata. Each deck is a markdown file named by slug (lowercase, hyphenated name). File structure: frontmatter with name, created date, source description, then cards as a YAML list. 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.
