imagegen

Generate and edit raster images using GPT Image models via built-in tool or CLI.

Updated Dec 20, 2025
One-click install
npx skills add https://github.com/koala-man-64/helpful-scripts --skill imagegen-koala-man-64
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: imagegen
Source: https://github.com/koala-man-64/helpful-scripts/tree/main/exports/codex-skills/home-shared/.system/imagegen
Command: npx skills add https://github.com/koala-man-64/helpful-scripts --skill imagegen-koala-man-64

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires openai, pillow, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve? Creating bitmap assets like photos, illustrations, sprites, mockups, and transparent cutouts normally requires design tools or manual API scripting; this Skill routes image generation and editing requests through a built-in image tool or a fallback CLI with structured prompting. ## Core Features & Use Cases - Dual-mode generation and editing: Uses the built-in image_gen tool by default, with a scripts/image_gen.py CLI fallback supporting generate, edit, and generate-batch subcommands against GPT Image models. - Transparent background workflow: Generates subjects on a flat chroma-key background and removes it locally with remove_chroma_key.py, with an opt-in gpt-image-1.5 true-transparency fallback. - Structured prompt augmentation: Classifies requests into a use-case taxonomy and normalizes prompts into a labeled spec covering scene, subject, style, composition, and constraints. - Use Case: A developer needs a landing-page hero image of a product; the Skill builds a product-mockup prompt spec, generates the image, and copies the final asset into the project workspace. ## Quick Start Ask the agent to generate a hero image of a ceramic coffee mug for the landing page and save it into the project workspace.

Frequently Asked Questions about imagegen

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate images with the imagegen skill?▼

Describe the image you want and the built-in image_gen tool generates it by default, with no API key required. The prompt is normalized into a structured spec covering use case, subject, style, composition, and constraints before generation.

How do I create an image with a transparent background?▼

The default path generates the subject on a flat chroma-key background, then remove_chroma_key.py converts the key color to alpha with soft matte and despill. True native transparency requires the CLI fallback with gpt-image-1.5 and background set to transparent, after explicit confirmation.

When should I use the image_gen.py CLI fallback instead of the built-in tool?▼

Use the CLI only when you explicitly need API or model controls such as quality, input fidelity, masks, output formats, or batch JSONL jobs. It requires OPENAI_API_KEY and the openai Python package, and defaults to the gpt-image-2 model.

Does gpt-image-2 support transparent backgrounds?▼

No, gpt-image-2 does not support the background=transparent parameter. Transparent output with gpt-image-2 uses the chroma-key generation plus local removal workflow, while gpt-image-1.5 supports true transparent backgrounds in png or webp format.

When should I not use AI image generation for a visual asset?▼

Avoid it when extending an existing SVG or vector icon system, creating simple diagrams or wireframes better done in HTML/CSS/canvas, or editing an asset that already exists in an editable native format. The skill targets bitmap output, not code-native visuals.