# Gpt Image Skill

Generate or edit images using OpenAI GPT Image API (gpt-image-2, gpt-image-1, etc).

- Repository: https://github.com/feiskyer/claude-code-settings (1668 stars)
- Category: Media
- License: MIT
- Last updated: 2026-09-27
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add feiskyer/claude-code-settings --skill gpt-image-skill -g -a claude-code -y`
Codex: `npx skills add feiskyer/claude-code-settings --skill gpt-image-skill -g -a codex -y`
Cursor: `npx skills add feiskyer/claude-code-settings --skill gpt-image-skill -g -a cursor -y`
Gemini CLI: `npx skills add feiskyer/claude-code-settings --skill gpt-image-skill -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add feiskyer/claude-code-settings`

## Description

Generate or edit images using OpenAI GPT Image API (gpt-image-2, gpt-image-1, etc). Use ONLY when the user explicitly names OpenAI or GPT as the provider: "gpt image", "openai image", "generate image with openai", "用 openai 画图", "用 GPT 生成图片". For generic image requests without a provider, use nanobanana-skill instead. Do NOT use for diagrams (架构图/流程图), draw those with Mermaid or code.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 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:

   ```bash
   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:

   ```bash
   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)

The rest: https://github.com/feiskyer/claude-code-settings/blob/HEAD/skills/gpt-image-skill/SKILL.md