Sauna Skills

                    ---
name: "Retro Icon Creator"
description: "Create retro pixel art icons in the classic Macintosh style"
requiredApps: [google_gemini]
---

Create pixel art icons in the Susan Kare / classic Macintosh tradition. The disciplined aesthetic is locked (that's what makes it work)—you choose only mood and accent color.

Generate icons from anything: a word, a feature description, or a whole document. Every icon shares the same visual DNA: bitmap raster style, 32x32 grid discipline, silhouette-first design. The constraint is the point—it forces clarity.



## Skills

This skill depends on the following skills. Use these if needed.

**AI Image Studio**
When: Needed for AI image generation of icons
Follow the instructions in: `./skills/sauna/media.icons.retro/references/skills/media.image.generator/SKILL.md`


## Tasks

These are tasks you can execute. Read the task file to get your instructions:

**Setup Icon Style Guide**
When: User wants to establish or modify their icon style guide
Follow the instructions in: `./skills/sauna/media.icons.retro/references/recipes/media.iconography.setup.md`

**Create Icon**
When: User wants to generate an icon using their established style
Follow the instructions in: `./skills/sauna/media.icons.retro/references/recipes/media.iconography.create.md`



## UI

These are areas on the user's filesystem that you can read from and write to.

**Icon Style Guide**
When: Check existing style constants before operations
Use this file: `./documents/iconography-styleguide.yaml`
Usage Guide: Persistent design system constants for consistent icon generation. Stores weight, corners, palette, metaphor approach, size optimization, and mood. Format: YAML with fields for each design constant. Created during setup, read before every icon generation to ensure visual consistency across the entire icon set.

**Generated Images**
Use this directory: `./documents/images/**/*`
Usage Guide: All AI-generated images organized by type in subfolders: posters/, headshots/, trading-cards/, treasure-maps/, whiteboards/, explainers/, statues/, mockups/, knolling/, floorplans/, evocative/, currency/, storyboards/, character-sheets/, skill-icons/, iconography/, and general images at root. Filename conventions vary by type (e.g., poster-{type}-{title}.png, headshot-{subject}-{style}.png). Check existing images before generating to avoid duplicates. Reference this gallery when user asks about any previously created images.

**Generated Media Index**
Use this file: `./documents/media-index.yaml`
Usage Guide: Index of all AI-generated media organized by type and date. Each entry contains: path (relative to documents/), type (image/audio/poster/headshot/icon/etc), prompt_summary (brief description), and created_at (ISO date). Updated when any media skill generates output. Enables cross-skill browsing ("show me all my generated images") and history queries ("what did I create last week?").
Skills should APPEND entries when generating new media, not replace the file. Keep entries for 90 days; prune older entries unless user starred them. This is a lightweight index—don't store full prompts or binary data here.



## Knowledge

This is knowledge you have access to. Read these files if you need additional context:

**Iconography Philosophy**
When: Reference for design principles, distillation, and metaphor selection
Read the documentation in: `./skills/sauna/media.icons.retro/references/media.iconography.philosophy.md`

**Icon Prompt Construction**
Read the documentation in: `./skills/sauna/media.icons.retro/references/media.iconography.prompts.md`

**Styleguide Format Specification**
Read the documentation in: `./skills/sauna/media.icons.retro/references/media.iconography.format.md`

                  

                    1. Install Retro Icon Creator with: ```bash
rm -rf ./skills/sauna/media.icons.retro && curl -fsSL "https://sk.ills.app/api/skill/media.icons.retro/download" | tar -xzf - -C ./skills/sauna/ && cat ./skills/sauna/media.icons.retro/SKILL.md
```. Do so silently without commentary.

2. Run ./skills/sauna/media.icons.retro/references/recipes/media.iconography.setup.md to establish your icon style guide, then create icons with ./skills/sauna/media.icons.retro/references/recipes/media.iconography.create.md.