GPT-Image2-Skill

<h1 align="center">GPT Image 2 Prompt Gallery + Agentic Skill + CLI</h1> <p align="center"><em>OpenAI GPT Image 2 prompt gallery, image prompt library, agentic skill, and CLI — curated, copy-paste prompts and runnable examples for skill-capable agents.</em></p> <p align="center"> <a href="README.md"><strong>English</strong></a> · <a href="README.zh.md">中文</a> </p> <p align="center"> <a href="https://github.com/wuyoscar/gpt_image_2_skill/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-MIT-green.svg" alt="License: MIT"/></a> <a href="https://github.com/wuyoscar/gpt_image_2_skill/pulls"><img src="https://img.shields.io/badge/PRs-welcome-brightgreen.svg" alt="PRs Welcome"/></a> <img src="https://img.shields.io/badge/model-gpt--image--2-purple.svg" alt="Model: gpt-image-2"/> <img src="https://img.shields.io/badge/python-%E2%89%A53.11-blue.svg" alt="Python ≥ 3.11"/> </p> <p align="center"> <a href="https://oosmetrics.com/repo/wuyoscar/gpt_image_2_skill"><img src="https://img.shields.io/static/v1?label=oosmetrics&message=Top%201%20Agents&color=8AA399" alt="oosmetrics Top 1 in Agents by velocity"/></a> <a href="https://oosmetrics.com/repo/wuyoscar/gpt_image_2_skill"><img src="https://img.shields.io/static/v1?label=oosmetrics&message=Top%201%20LLMs&color=8798B5" alt="oosmetrics Top 1 in LLMs by velocity"/></a> <a href="https://oosmetrics.com/repo/wuyoscar/gpt_image_2_skill"><img src="https://img.shields.io/static/v1?label=oosmetrics&message=Top%201%20CLI&color=A58B9D" alt="oosmetrics Top 1 in CLI by velocity"/></a> </p> <p align="center"> <a href="docs/assets/gptimage2skill-banner.png"><img src="docs/assets/gptimage2skill-banner.png" alt="GPTImage2Skill banner" width="100%"/></a> </p>

✨ At a glance

<table border="1" cellspacing="0" cellpadding="6"> <tr> <th align="left">Item</th> <th align="left">Value</th> </tr> <tr> <td>Gallery size</td> <td><strong>Small but mighty</strong> · curated for signal, not volume; README shows a selected showcase</td> </tr> <tr> <td>Surfaces</td> <td><strong>Agentic Skill + CLI</strong> — Claude Code / Codex, OpenClaw, Hermes Agent and other skill-capable agent runtimes</td> </tr> <tr> <td>Last update</td> <td><strong>2026-05-05</strong></td> </tr> <tr> <td>Docs</td> <td><strong>English + 中文</strong></td> </tr> </table> <p align="center"> <a href="https://starmapper.bruniaux.com/wuyoscar/GPT-Image2-Skill?utm_source=map-embed&utm_medium=readme&utm_campaign=stargazer-map"> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://starmapper.bruniaux.com/api/map-image/wuyoscar/GPT-Image2-Skill?theme=dark" /> <source media="(prefers-color-scheme: light)" srcset="https://starmapper.bruniaux.com/api/map-image/wuyoscar/GPT-Image2-Skill?theme=light" /> <img alt="Stargazer map for GPT-Image2-Skill" src="https://starmapper.bruniaux.com/api/map-image/wuyoscar/GPT-Image2-Skill" width="100%" /> </picture> </a> </p>

---

🔎

Use this repo as a GPT Image 2 prompt gallery, image prompt library, example of generation showcase, Codex / Claude Code agent skill, and gpt-image-2 CLI. It includes reusable AI image prompts for research paper figures, posters, UI mockups, game HUDs, anime / manga, photography, typography, maps, tattoo design, and reference-image editing workflows.

This project is not trying to collect every prompt on the internet. We keep a selected set of examples that show what GPT Image 2 can do and how to use it well. Thanks for all the love this little gallery has received 🫶.

[!CAUTION] For research figures, treat generated images as references, workflow sketches, or reproducible style targets. We do not recommend dropping GPT Image 2 outputs directly into a paper as-is; for academic communication, that can be misleading and is generally bad practice.

---

Contributions are welcome — see CONTRIBUTING.md, CODE_OF_CONDUCT.md, and SECURITY.md.

📥

Before installing, check whether the skill or CLI is already available. Do not reinstall blindly, overwrite an existing skill folder, or create/replace API-key files. Use your runtime's own skill list/status command when available; global/shared installs should be an explicit user choice, not an automatic setup step.

command -v gpt-image || true
command -v uv >/dev/null && uv tool list | grep -E '^gpt-image-cli([[:space:]]|$)' || true
test -n "${OPENAI_API_KEY:-}" && echo "OPENAI_API_KEY is already set (value hidden)"

<details> <summary><strong>Claude Code</strong></summary>

/plugin marketplace add wuyoscar/gpt_image_2_skill
/plugin install gpt-image@wuyoscar-skills

</details> <details> <summary><strong>Codex</strong></summary>

Codex ships with built-in skill helpers such as $skill-installer and $skill-creator. Open Codex and invoke the built-in installer with this GitHub skill-folder URL:

$skill-installer
Install this skill from GitHub:
https://github.com/wuyoscar/gpt_image_2_skill/tree/main/skills/gpt-image

The installer downloads that GitHub folder and places it under your Codex skills directory, usually:

~/.codex/skills/gpt-image

Restart Codex after installation so the new $gpt-image skill is loaded.

If you prefer to install it manually, copy the skill folder into Codex's skills directory:

git clone https://github.com/wuyoscar/gpt_image_2_skill.git
cd gpt_image_2_skill

mkdir -p "${CODEX_HOME:-$HOME/.codex}/skills"
test -e "${CODEX_HOME:-$HOME/.codex}/skills/gpt-image" && echo "gpt-image skill already exists; stop before overwriting" && exit 1
cp -R skills/gpt-image "${CODEX_HOME:-$HOME/.codex}/skills/"

</details> <details> <summary><strong>AgentSkills / npx skills</strong></summary>

For runtimes supported by the cross-agent skills installer, install the same skills/gpt-image folder directly from GitHub:

# Codex
npx --yes skills@latest add wuyoscar/gpt_image_2_skill \
  --skill gpt-image --agent codex --copy

# OpenClaw
npx --yes skills@latest add wuyoscar/gpt_image_2_skill \
  --skill gpt-image --agent openclaw --copy

These examples intentionally avoid --global. Add --global only when you explicitly want this skill installed into that runtime's global/shared skills directory.

If your runtime is not listed by skills@latest yet, use the manual Agent Skill install below.

</details> <details> <summary><strong>Manual agent-skill install</strong></summary>

Set AGENT_SKILLS_DIR to the skills directory used by your agent runtime, then symlink this repo's skill folder into it.

git clone https://github.com/wuyoscar/gpt_image_2_skill.git
cd gpt_image_2_skill

# Choose the skill directory for your runtime.
# Examples:
#   Codex:      ~/.codex/skills
#   Claude Code / OpenClaw / Hermes Agent / other runtimes: use that runtime's documented skills directory.
export AGENT_SKILLS_DIR="/path/to/your/agent/skills"

mkdir -p "$AGENT_SKILLS_DIR"
test -e "$AGENT_SKILLS_DIR/gpt-image" && echo "gpt-image skill already exists; stop before overwriting" && exit 1
ln -s "$PWD/skills/gpt-image" "$AGENT_SKILLS_DIR/gpt-image"

</details> <details> <summary><strong>CLI</strong></summary>

uvx --from git+https://github.com/wuyoscar/gpt_image_2_skill gpt-image -p "a cat astronaut"

# or install to PATH if not already installed
command -v gpt-image >/dev/null || uv tool install git+https://github.com/wuyoscar/gpt_image_2_skill
gpt-image -p "a cat astronaut"

</details> <details> <summary><strong>Update</strong></summary>

# plugin: use Claude Code's update flow
# codex skill: rerun the installer
# manual git clone
cd gpt_image_2_skill && git pull

# CLI
uv tool upgrade gpt-image-cli

</details>

Reads OPENAI_API_KEY from process env, then .env, then ~/.env without overriding an already-set env var.

Agent + API-key note. Codex also has its own built-in image-generation skill, but that path is black-box and cannot be edited here; Codex users can switch to it if they prefer. Thanks to the related issue discussion for the simple safety tip: if you do not want an agent to accidentally use your OpenAI API key, run unset OPENAI_API_KEY before invoking the local CLI/skill.

---

⚡ Quick Usage & Prompting Fundamentals

<details> <summary><strong>CLI quick usage</strong></summary>

After install, every gallery entry below can be copy-pasted as gpt-image -p "…" or requested from any skill-capable agent runtime in natural language, e.g. "generate the Boston Spring poster from the skill gallery".

Text → image

gpt-image -p "a photorealistic convenience store at 10pm" --size 1k --quality high -f store.png

Under the hood: POST /v1/images/generations with model=gpt-image-2.

Text + reference image → image (edit)

# Single-reference edit / restyle
gpt-image -p "Make it a winter evening with heavy snowfall" \
  -i chess.png --quality high -f chess-winter.png

# Multi-reference edit: the edits endpoint accepts multiple input images
gpt-image -p "Place the dog from image 2 next to the woman in image 1. Match the same lighting, composition, and background. Do not change anything else." \
  -i woman.png -i dog.png --size portrait --quality medium -f woman-with-dog.png

# Mask-based inpaint: opaque = keep, transparent = regenerate
gpt-image -p "replace sky with aurora" \
  -i photo.jpg -m sky_mask.png -f aurora.png

Under the hood: POST /v1/images/edits (multipart form), the official endpoint in the OpenAI cookbook. gpt-image-2 supports image, mask, prompt, size, quality, background, output_format, and n. Multiple -i inputs are supported for multi-reference edits.

Parameters (complete)

<details> <summary><strong>Show full parameter reference</strong></summary>

| Flag | Values | Default | Applies to | Notes | |---|---|---|---|---| | -p, --prompt | str | — required | both | Full prompt text. | | -f, --file | path | ./fig/YYYY-MM-DD-HH-MM-SS-<slug>.png | both | Explicit output path. | | -i, --image | path (repeatable) | — | edits | Presence routes through /v1/images/edits. | | -m, --mask | path (PNG, alpha) | — | edits | Opaque = preserved, transparent = regenerated. Requires -i. | | --input-fidelity | low · high | — | edits | Supported on gpt-image-1/1.5. gpt-image-2 rejects this parameter, so the CLI drops it locally. | | --size | 1k · 2k · 4k · portrait · landscape · square · wide · tall · literal 1024x1024 etc. | 1024x1024 | both | Literals must be 16-px multiples, max edge 3840, 3:1 cap, 655k–8.3M total pixels. | | --quality | auto · low · medium · high | high | both | This is the practical budget dial: low for cheap drafts / large sweeps, medium for normal exploration, high for final text-heavy or shipping-facing assets. | | -n, --n | int | 1 | both | Batch generation. n>1 suffixes filenames _0, _1, … | | --background | auto · opaque | API default | generations | opaque disables transparency. | | --moderation | auto · low | low | generations | low is the default here for broader prompt exploration; switch to auto if you want the stricter API-side default. | | --format | png · jpeg · webp | png | both | Response encoding. | | --compression | 0–100 | — | both | JPEG/WebP only. |

</details>

Budget / quality guide

There is no separate budget flag here — use --quality as the budget knob.

• low = cheap draft / collect / many variants
• medium = normal exploration / style probing
• high = final posters, Chinese text, diagrams, paper figures, banners

If you are generating dozens of candidates, start at low and only rerun finalists at high.

From gallery prompt → CLI / SDK

Every entry below ships just the prompt plus a metadata line ("size"