# Generate Images > Media Renderer. Load when IMAGE_SPEC.md exists or the user explicitly requests presentation image rendering. - Skill: `ken-guru/generate-images` (Agent Skill, multi-file: 9 files) - Install (CLI): `npx skillmds@latest add ken-guru/generate-images` - Raw SKILL.md: https://api.skillmd.com/api/skills/ken-guru/generate-images/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - Author: ken-guru (https://skillmd.com/u/ken-guru) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/ken-guru/generate-images --- # Generate Images (Media Renderer) Reads `IMAGE_SPEC.md`, submits each entry's prompt to an AI image generation API, and saves the resulting PNG files to the project's `images/` folder. ## Output voice Apply a lightweight human-voice pass to scope questions, review prompts, and result reports. Keep prompts and user-provided Media Intent intact when transporting them, and keep filenames, paths, commands, and state values exact. Before approving any presentation-facing text, invoke the standalone `unslop` Skill as a required full editorial pass using `DISCOVERY.json.editorialPreferences`; preserve prompts and machine-readable media metadata where their contract requires exact wording. Protocol: resolve Media Scope, choose Generation Mode, review and report results, update only the owned media phase, leave it pending on cancellation or failure, and preserve unrelated phase records. Provider setup remains local. ## Startup Before proceeding: 1. Resolve the project folder: check `DISCOVERY.json` for the `paths.imageSpec` field, or ask if ambiguous. 2. Check `IMAGE_SPEC.md` exists. If not: > ❌ `IMAGE_SPEC.md` not found. Create and approve an image specification before rendering images. Abort. 3. Provider and model resolve automatically inside the script — from `--provider=`/`--model=` flags, `GEMINI_API_KEY`/`OPENAI_API_KEY`, or any prior choice persisted in `PROJECT.json`. No separate check is needed here: if misconfigured, the script exits with a clear, actionable error pointing at [PROVIDERS.md](PROVIDERS.md). 4. Check `node` is available: `which node`. If not found, abort: ❌ `node` not installed. 5. Resolve the absolute directory containing this invoked `SKILL.md`. Set the runtime bundle path to `/scripts/generate-images.js` and require that file to exist. Quote the absolute path whenever invoking it. Never infer the path from cwd or an agent-home convention, and never install runtime dependencies. ## Procedure ### Step 1: Resolve scope Parse all entries from `IMAGE_SPEC.md`. Check which filenames already exist in the project folder. If **no images exist yet**, scope = all entries — skip to Step 2. If **at least one image already exists**, present: ``` ⚠️ images/ — existing files detected (N of M images already present) Already present: • images/foo.png (Slide 1 — Title) [...] Not yet generated: • images/bar.png (Slide 3 — Title) [...] A Generate missing only — skip the N that already exist B Regenerate everything — overwrite all M images C Choose specific slides — I'll tell you which slide numbers D Cancel ``` Wait for choice. For **C**, follow up: "Which slide numbers? (e.g. `1 3 5`)" ### Step 2: Select generation mode ``` 💡 N image(s) will be generated using () See PROVIDERS.md for pricing details. 1 All at once — generate selected images in sequence 2 One at a time — pause after each image for your review ``` ### Step 3: Generate **Batch (choice 1)** ```bash node "/scripts/generate-images.js" \ "" [--force] [--slides=N,M,...] [--provider=] [--model=] [--delay=] ``` - Scope A → no extra flags (script skips existing files by default) - Scope B → add `--force` - Scope C → add `--slides=N,M,...` **Interactive (choice 2)** For each image in scope, run: ```bash node "/scripts/generate-images.js" \ "" --slide=N --force [--provider=] [--model=] ``` After each, present: ``` ✅ Saved: images/foo.png (Slide N — Title) Open to review, then choose: N Next — accept and continue to the next image R Redo — regenerate with the same prompt (different result) S Stop — exit and keep what has been generated so far ``` Note: to change a prompt before redoing, edit `IMAGE_SPEC.md` first, then choose R. **R** re-runs the same script call. **S** exits the loop early. ### Step 4: Report results Present the script's summary output. On failure, suggest editing the prompt in `IMAGE_SPEC.md` and retrying with `--slide=N`. ## Options These flags bypass the interactive prompts — useful for scripting or repeat runs. | Flag | Effect | |------|--------| | `--force` | Skip scope prompt — regenerate all images in batch | | `--slide=N` | Skip all prompts — generate only slide N | | `--slides=N,M,...` | Skip scope prompt — generate specific slides in batch | | `--provider=` | Override the auto-detected provider (see [PROVIDERS.md](PROVIDERS.md)) | | `--model=` | Override the default model for the resolved provider (see [PROVIDERS.md](PROVIDERS.md#models)) | | `--delay=` | Pause between requests (default: 1s; increase to avoid rate limits — see [PROVIDERS.md](PROVIDERS.md)) | ## Providers Auto-detected from whichever key is set — `GEMINI_API_KEY` or `OPENAI_API_KEY`. Gemini is the default when both are present. Override with `--provider=gemini|openai`. For setup and security guidance, see [PROVIDERS.md](PROVIDERS.md). ## Project state Read `paths.imageSpec` and `paths.images` from `DISCOVERY.json`, falling back to `IMAGE_SPEC.md` and `images/`. The script persists the resolved `provider`, `providerSource`, `model`, and `modelSource` (see [docs/state-schema.md](../docs/state-schema.md)) to `PROJECT.json` `phases.images` as soon as they're resolved, independent of generation outcome. After all selected entries succeed, set `phases.images.status` to `"done"` and record its completion timestamp. On cancellation or any failed entry, do not mark the phase done.