gpt-image-skill
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.
npx skills add feiskyer/claude-code-settings --skill gpt-image-skill --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# 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
- Requirements
- Instructions
- For image generation
- For image editing
- Available Options
- Models (--model)
- Sizes (--size)
- Quality (--quality)
- Output Format (--format)
- Background (--background)
- Other Options
- Examples
- Generate a simple image
- Generate with specific size and output
python3 ${CLAUDE_SKILL_DIR}/gpt_image.py --prompt "description of image" --output "filename.png"
python3 ${CLAUDE_SKILL_DIR}/gpt_image.py edit --prompt "editing instructions" --input image1.png image2.png --output "edited.png"
python3 ${CLAUDE_SKILL_DIR}/gpt_image.py --prompt "A serene mountain landscape at sunset with a lake"
python3 ${CLAUDE_SKILL_DIR}/gpt_image.py \
python3 ${CLAUDE_SKILL_DIR}/gpt_image.py edit \What does the gpt-image-skill skill do?
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.
How do I install it?
Run `npx skills add feiskyer/claude-code-settings --skill gpt-image-skill --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From feiskyer/claude-code-settings, a repository with 1,619 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.
