Agent skill · Backend & API

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.

feiskyergithub.com/feiskyerGitHub ↗
claude-codecodexcopilotcan modify filesships scriptsMIT
Install
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.

Facts
Files in the skill folder: 4
SKILL.md size: 5 KB
Bundled scripts: yes
Allowed tools: ReadWriteGlobGrepTaskBash(cat:*)Bash(ls:*)Bash(tree:*)Bash(python3:*)
Path: skills/gpt-image-skill/SKILL.md
Open the folder on GitHub →
Where it comes from
Stars: 1,619
Language: Python

Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.

From the SKILL.md

# 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

What's inside
Steps it walks through
  1. Requirements
  2. Instructions
  3. For image generation
  4. For image editing
  5. Available Options
  6. Models (--model)
  7. Sizes (--size)
  8. Quality (--quality)
  9. Output Format (--format)
  10. Background (--background)
  11. Other Options
  12. Examples
  13. Generate a simple image
  14. Generate with specific size and output
Ships with 3 files
  • evals/evals.json
  • gpt_image.py
  • requirements.txt
Commands it runs
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 \
More from claude-code-settings
All skills →
About this skill
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.

Keep going