GPT Image Skill

Generate or edit images using OpenAI's GPT Image models through a bundled Python script.

Requirements

1. OPENAI_API_KEY: Must be configured in ~/.gpt-image.env or export OPENAI_API_KEY=<your-key>
2. OPENAI_API_BASE (optional): Custom API base URL for compatible endpoints (e.g. Azure OpenAI, proxies). Set in ~/.gpt-image.env or export it.
3. Python3 with dependencies: openai, Pillow. Install via python3 -m pip install -r ${CLAUDE_SKILL_DIR}/requirements.txt if not installed yet.
4. Executable: ${CLAUDE_SKILL_DIR}/gpt_image.py

Instructions

For image generation

1. Ask the user for:

   • What they want to create (the prompt)
   • Desired size (optional, defaults to 1024x1024)
   • Output filename (optional, auto-generates UUID-based name if not specified)
   • Model preference (optional, defaults to gpt-image-2)
   • Quality (optional, defaults to auto)
   • Number of images (optional, defaults to 1)

2. Run the script:

   python3 ${CLAUDE_SKILL_DIR}/gpt_image.py --prompt "description of image" --output "filename.png"
   

3. Show the user the saved image path when complete.

For image editing

1. Ask the user for:

   • Input image file(s) to edit (up to 3)
   • What changes they want (the prompt)
   • Output filename (optional)

2. Run with input images:

   python3 ${CLAUDE_SKILL_DIR}/gpt_image.py edit --prompt "editing instructions" --input image1.png image2.png --output "edited.png"
   

Available Options

Models (--model)

• gpt-image-2 (default), Latest model with strong instruction following, text rendering, and broad world knowledge
• gpt-image-1.5, Mid-tier model
• gpt-image-1, First-generation GPT image model
• gpt-image-1-mini, Lightweight, faster generation

Sizes (--size)

• 1024x1024 (default), Square
• 1024x1536, Portrait (2:3)
• 1536x1024, Landscape (3:2)
• auto, Let the model decide

Quality (--quality)