| name | imagegen |
| description | Use when the user asks to generate or edit images via the OpenAI Image API (for example: generate image, edit/inpaint/mask, background removal or replacement, transparent background, product shots, concept art, covers, or batch variants); run the bundled CLI (`scripts/image_gen.py`) and require `OPENAI_API_KEY` for live calls. |
| zh_description | 用于生成、编辑和迭代图像内容与视觉素材。 |
| version | 1.0.0 |
| author | seaworld008 |
| source | in-house |
| source_url | |
| tags | ["imagegen"] |
| created_at | 2026-03-04 |
| updated_at | 2026-03-20 |
| quality | 4 |
| complexity | intermediate |
Image Generation Skill
Generates or edits images for the current project (e.g., website assets, game assets, UI mockups, product mockups, wireframes, logo design, photorealistic images, infographics). Defaults to gpt-image-1.5 and the OpenAI Image API, and prefers the bundled CLI for deterministic, reproducible runs.
When to use
- Generate a new image (concept art, product shot, cover, website hero)
- Edit an existing image (inpainting, masked edits, lighting or weather transformations, background replacement, object removal, compositing, transparent background)
- Batch runs (many prompts, or many variants across prompts)
Decision tree (generate vs edit vs batch)
- If the user provides an input image (or says “edit/retouch/inpaint/mask/translate/localize/change only X”) → edit
- Else if the user needs many different prompts/assets → generate-batch
- Else → generate
Workflow
- Decide intent: generate vs edit vs batch (see decision tree above).
- Collect inputs up front: prompt(s), exact text (verbatim), constraints/avoid list, and any input image(s)/mask(s). For multi-image edits, label each input by index and role; for edits, list invariants explicitly.
- If batch: write a temporary JSONL under tmp/ (one job per line), run once, then delete the JSONL.
- Augment prompt into a short labeled spec (structure + constraints) without inventing new creative requirements.
- Run the bundled CLI (
scripts/image_gen.py) with sensible defaults (see references/cli.md).
- For complex edits/generations, inspect outputs (open/view images) and validate: subject, style, composition, text accuracy, and invariants/avoid items.
- Iterate: make a single targeted change (prompt or mask), re-run, re-check.
- Save/return final outputs and note the final prompt + flags used.
Temp and output conventions
- Use
tmp/imagegen/ for intermediate files (for example JSONL batches); delete when done.
- Write final artifacts under
output/imagegen/ when working in this repo.
- Use
--out or --out-dir to control output paths; keep filenames stable and descriptive.
Dependencies (install if missing)
Prefer uv for dependency management.
Python packages:
uv pip install openai pillow
If uv is unavailable:
