To run this task you must have the following required information:

> Content to create flashcards from, OR a topic to study

If you don't have all of this information, exit here and respond asking for any extra information you require, and instructions to run this task again with ALL required information.

---

You MUST use a todo list to complete these steps in order. Never move on to one step if you haven't completed the previous step. If you have multiple read steps in a row, read them all at once (in parallel).

Add all steps to your todo list now and begin executing.

## Steps

1. STOP. Do not generate cards yet. First, understand what the user actually
wants to learn.

**If they gave just a topic** (a few words like "AI context management",
"Spanish verbs", "AWS"):

You MUST ask clarifying questions before proceeding. Ask about:
- Their goal: Why are they learning this? (exam, job, curiosity?)
- Their level: Beginner, intermediate, or already know the basics?
- Their lens: What angle matters to them? (e.g., "AI context" could mean
  building AI systems, prompt engineering, or using AI tools)
- Specific focus: Any particular subtopics or areas to emphasize?

Do NOT proceed until the user has answered and you have a clear, specific
scope. "AI and context management" is too vague — push back.

**If they provided substantial content** (paragraphs of notes, an article):
Confirm: "This covers [topics]. Should I make cards for all of it, or
focus on a specific section?"


2. Now that you have a clear scope:

**If topic only:** Research it using web search. Tell them: "Let me look
up the key concepts for [specific topic + their lens]..."
Search for educational content, definitions, common exam questions, and
core vocabulary. Gather enough material to create good cards.

**If content provided:** Proceed to card generation.


3. [Read Flashcard Creation Guide]: Read the documentation in: `skills/sauna/[skill_id]/references/study.flashcards.creation.md` (How to generate effective flashcards)

4. Generate 8-15 high-quality flashcards from the content (user-provided or
researched). Follow the guidance in the slice.

Each card should test one concept with a clear question and concise answer.
Suggest a descriptive deck name based on the topic.

Write the cards to `session/flashcards-new-cards.json` with this structure:
{
  "deckName": "Descriptive Name",
  "sourceDescription": "Brief description of the source content",
  "cards": [
    { "front": "Question", "back": "Answer" }
  ]
}

Tell the user how many cards you generated and what the deck will be called.


5. [Gather Arguments: Save Flashcard Deck] The next step has the following requirements for arguments, do not proceed until you have all the required information:
- `newCardsPath`: session/flashcards-new-cards.json
- `decksPath`: documents/flashcard-decks.json

6. [Run Code: Save Flashcard Deck]: Call `run_script` with:

```json
{
  "file": {
    "path": https://sk.ills.app/code/study.flashcards.save/preview,
    "args": [
      "newCardsPath",
      "decksPath"
    ]
  },
  "packages": null
}
```

7. Confirm the deck was saved. Tell them the deck name and card count.

Then explicitly ask: "Want to start reviewing now, or save for later?"

If they want to review now, run `skills/sauna/[skill_id]/references/recipes/study.flashcards.review.md`.