agentleFS
Sign inStart free
OpenClaudiaOpenClaudia/openclaudia-skills/skills/ai-image-gen/SKILL.md

generate-image

Skill724 starsChanged 5 months agoMITView on GitHub

Generate images using AI (OpenAI GPT Image or Stability AI). Use when the user asks to generate an image, create an AI image, make an illustration, or produce artwork from a text prompt.

  • Reads credentials
  • Installs packages
Create a free account to mount
Files
SKILL.md

AI Image Generation

Generate images from text prompts using OpenAI GPT Image (gpt-image-2 / gpt-image-1 / variants) or Stability AI (SD 3.5 Large).

Tool Location

  • Script: ~/.agents/tools/generate-image.py
  • Env file: ~/.agents/tools/.env (contains OPENAI_API_KEY and STABILITY_API_KEY)

Available OpenAI image models (verified live via /v1/models 2026-05-15)

Model IDNotes
gpt-image-2Flagship. Released 2026-04-21. Best prompt adherence, best photorealism. Default when image quality matters.
gpt-image-2-2026-04-21Pinned dated variant of gpt-image-2
gpt-image-1.5Intermediate release between 1 and 2
gpt-image-1-miniSmaller/cheaper gpt-image-1 variant — use for batch/draft generation where cost matters
gpt-image-1Original gpt-image. Still works; superseded by gpt-image-2.
chatgpt-image-latestAlways-current alias of the model ChatGPT.com uses (currently gpt-image-2-class). Use when you want "whatever ChatGPT uses today"
dall-e-3Legacy fallback. Different quality semantics (standard/hd, not low/medium/high).

Pass any of these to --model. The script branches on gpt-image* for the quality/format handling, so all gpt-image-* variants work out of the box.

Default in the script is now gpt-image-2 (the flagship) — pass --model gpt-image-1-mini for cheap batch/draft work.

Quick Usage

Generate with OpenAI gpt-image-2 (flagship)

python ~/.agents/tools/generate-image.py \
  --prompt "a sunset over mountains, oil painting style" \
  --output ./sunset.png \
  --model gpt-image-2 \
  --quality high

Generate with default (gpt-image-2)

python ~/.agents/tools/generate-image.py \
  --prompt "a sunset over mountains, oil painting style" \
  --output ./sunset.png

High quality

python ~/.agents/tools/generate-image.py \
  --prompt "modern logo design for a tech company" \
  --output ./logo.png \
  --size 1024x1024 \
  --quality high

Wide format (good for blog covers, banners)

python ~/.agents/tools/generate-image.py \
  --prompt "abstract digital art with blue tones" \
  --output ./banner.png \
  --size 1536x1024

Tall format (good for mobile, stories)

python ~/.agents/tools/generate-image.py \
  --prompt "portrait of a futuristic city" \
  --output ./city.png \
  --size 1024x1536

Transparent background (icons, logos)

python ~/.agents/tools/generate-image.py \
  --prompt "a minimalist cat icon, flat design" \
  --output ./icon.png \
  --background transparent

Generate with Stability AI (SD 3.5 Large)

python ~/.agents/tools/generate-image.py \
  --prompt "watercolor painting of a garden" \
  --output ./garden.png \
  --provider stability

CLI Options

OptionDescription
--prompt, -p(Required) Text prompt describing the desired image
--output, -o(Required) Output file path
--provideropenai (default) or stability
--sizeImage size for OpenAI: 1024x1024 (default), 1536x1024 (wide), 1024x1536 (tall)
--qualityOpenAI quality: low, medium (default), or high
--backgroundOpenAI background: auto (default), transparent, or opaque
--modelOverride model (default: gpt-image-2 for OpenAI, sd3.5-large for Stability)

Provider Comparison

FeatureOpenAI gpt-image-2OpenAI gpt-image-1Stability AI SD 3.5
Released2026-04-212025—
Prompt adherenceBestExcellentGood
Size options1024x1024, 1536x1024, 1024x15361024x1024, 1536x1024, 1024x15361024x1024
Quality optionslow, medium, highlow, medium, highN/A
Transparent bgYesYesNo
StylePhotorealistic + artisticPhotorealistic + artisticArtistic + photorealistic
Cost per image (high)Higher than 1BaselineN/A

Dependencies

  • requests (for API calls)

Install if needed:

pip install requests

Output

The script prints:

  • The provider and model used
  • The prompt (and revised prompt if applicable)
  • The saved file path

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

Reviews can't be read right now.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

Check your setup, free