Agent skill · design visual · openai
imagegen
Generate or edit raster images when the task benefits from AI-created bitmap visuals such as photos, illustrations, textures, sprites, mockups, or transparent-background cutouts. Use when Codex should create a brand-new image, transform an existing image, or derive visual variants from references, and the output should be a bitmap asset rather than repo-native code or vector. Do not use when the task is better handled by editing existing SVG/vector/code-native assets, extending an established icon or logo system, or building the visual directly in HTML/CSS/canvas.
Why this skill is useful
Adds specific commands for image generation and editing that the AI wouldn't reliably generate on its own.
What it needs
Requires openai account access. About 11k tokens when loaded. Last updated 2026-08-07. 104,481 stars on the source repository.
What this skill does
Image Generation Skill Generates or edits images for the current project (for example website assets, game assets, UI mockups, product mockups, wireframes, logo design, photorealistic images, or infographics). Top-level modes and rules This skill has exactly two top-level modes: Default built-in tool mode (preferred): built-in imagegen tool for image generation, editing, and transparent-image requests. Does not require OPENAIAPIKEY. Fallback CLI mode: scripts/imagegen.py CLI. Use when the user explicitly asks for or confirms the CLI/API/model path. Requires OPENAIAPIKEY. Within CLI fallback, the CLI exposes three subcommands: generate edit generate-batch Rules: Use the built-in imagegen tool by default for normal image generation and editing requests. Do not switch to CLI fallback for ordinary quality, size, or file-path control. For transparent images, ask built-in imagegen for a transparent background and preserve the generated alpha. Never silently switch from built-in imagegen or CLI gpt-image-2 to CLI gpt-image-1.5; ask the user first unless they explicitly requested gpt-image-1.5. The word batch by itself does not mean CLI fallback. If the user asks for many assets or says to batch-generate assets without explicitly asking for CLI/API/model controls, stay on the built-in path and issue one built-in call per requested asset or variant. If the built-in tool fails or is unavailable, tell the user the CLI fallback exists and that it requires OPENAIAPIKEY. Proceed only if the user explicitly asks for that fallback. If the user explicitly asks for CLI mode, use the bundled scripts/imagegen.py workflow. Do not create one-off SDK runners. Never modify scripts/imagegen.py. If something is missing, ask the user before doing anything else. Built-in save-path policy: In built-in tool mode, Codex saves generated images under $CODEXHOME/ by default. Do not describe or rely on OS temp as the default built-in destination. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills openai/imagegen