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

> Anything that needs an icon—a word, sentence, paragraph, document, conversation, or abstract idea

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. [Run Code: Verify Gemini Connection]: Call `run_script` with:

```json
{
  "file": {
    "path": https://sk.ills.app/code/media.gemini.verify/preview,
    "args": [

    ]
  },
  "packages": null
}
```

2. [Read Icon Style Guide]: Read the file at `./documents/iconography-styleguide.yaml` and analyze its contents (Load the comprehensive style guide)

3. If no style guide exists, tell the user they need to set one up first and offer to help. Then stop and wait for their response.

4. [Read Iconography Philosophy]: Read the documentation in: `./skills/sauna/[skill_id]/references/media.iconography.philosophy.md` (Load design principles, distillation process, and metaphor selection)

5. [Read Icon Prompt Construction]: Read the documentation in: `./skills/sauna/[skill_id]/references/media.iconography.prompts.md` (Load prompt construction guide)

6. If the user hasn't provided input, invite them: "What do you need an icon for? This can be anything—a word, a feature description, a paragraph, or a whole document. I'll distill it into the perfect metaphor."

7. DISTILL THE ESSENCE using the process in `./skills/sauna/[skill_id]/references/media.iconography.philosophy.md`: 1. Absorb the full input 2. Find the core concept (what is this REALLY about?) 3. Express in 1-3 words 4. Find the physical metaphor 5. Validate it communicates without context
Share your thinking: "The core concept here is [X]. A [metaphor] would capture that because [reasoning]. Does that feel right?" Iterate if needed.

8. CONSTRUCT THE PROMPT using the styleguide's visual_dna section. Combine: "[Metaphor] icon. [visual_dna.weight], [visual_dna.corners], [visual_dna.palette], [visual_dna.metaphor], [visual_dna.size], [visual_dna.mood]. Clean iconographic style, centered composition, no background elements, suitable for UI/app interface."

9. [Gather Arguments: Generate or Edit Image] The next step has the following requirements for arguments, do not proceed until you have all the required information:
- `prompt`: the complete constructed prompt
- `imagePath`: empty string—no source image
- `outputDir`: ui:media.image.gallery (subdirectory: iconography/)

10. [Run Code: Generate or Edit Image]: Call `run_script` with:

```json
{
  "file": {
    "path": https://sk.ills.app/code/media.image.generate/preview,
    "args": [
      "prompt",
      "imagePath",
      "outputDir"
    ]
  },
  "packages": null
}
```

11. Append an entry to `./documents/media-index.yaml` with: path (the saved icon path), type: icon, prompt_summary (the distilled metaphor), created_at (ISO date).

12. Show where the icon was saved. Offer: "Want to create another icon? Just describe what you need." If they want to adjust, regenerate. If they want to change overall style, suggest updating the style guide.