gpt-image-skill

1# GPT Image Skill
2 
3Generate or edit images using OpenAI's GPT Image models through a bundled Python script.
4 
5## Requirements
6 
71. **OPENAI_API_KEY**: Must be configured in `~/.gpt-image.env` or `export OPENAI_API_KEY=<your-key>`
82. **OPENAI_API_BASE** (optional): Custom API base URL for compatible endpoints (e.g. Azure OpenAI, proxies). Set in `~/.gpt-image.env` or export it.
93. **Python3 with dependencies**: openai, Pillow. Install via `python3 -m pip install -r ${CLAUDE_SKILL_DIR}/requirements.txt` if not installed yet.
104. **Executable**: `${CLAUDE_SKILL_DIR}/gpt_image.py`
11 
12## Instructions
13 
14### For image generation
15 
161. Ask the user for:
17   - What they want to create (the prompt)
18   - Desired size (optional, defaults to 1024x1024)
19   - Output filename (optional, auto-generates UUID-based name if not specified)
20   - Model preference (optional, defaults to gpt-image-2)
21   - Quality (optional, defaults to auto)
22   - Number of images (optional, defaults to 1)
23 
242. Run the script:
25 
26   ```bash
27   python3 ${CLAUDE_SKILL_DIR}/gpt_image.py --prompt "description of image" --output "filename.png"
28   ```
29 
303. Show the user the saved image path when complete.
31 
32### For image editing
33 
341. Ask the user for:
35   - Input image file(s) to edit (up to 3)
36   - What changes they want (the prompt)
37   - Output filename (optional)
38 
392. Run with input images:
40 
41   ```bash
42   python3 ${CLAUDE_SKILL_DIR}/gpt_image.py edit --prompt "editing instructions" --input image1.png image2.png --output "edited.png"
43…