Agent skill

Gpt Image Skill

by feiskyer in feiskyer/codex-settings

Generate or edit images when the user names OpenAI, GPT Image, or a gpt-image model.

MITAuto-check passedMedia & Creative

Install Gpt Image Skill

skills CLI
$ npx skills add feiskyer/codex-settings --skill gpt-image-skill -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install feiskyer/codex-settings gpt-image-skill --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/feiskyer/codex-settings.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/gpt-image-skill .claude/skills/gpt-image-skill && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
gpt-image-skill
GitHub stars
244
Token cost
~572 tokens
SKILL.md length
253 words
Files
6
Skills in repo
11
Repo updated
First seen
Licence
MIT

At a glance

Generate or edit images when the user names OpenAI, GPT Image, or a gpt-image model.

  • Works in 4 steps: OPENAI_API_KEY in ~/.gpt-image.env or… → OPENAI_API_BASE (optional) for… → Python dependencies: python3 -m pip… → …
  • A gpt-image model
  • SKILL.md covers Resolve the skill directory, Requirements, Run it and When a run fails
  • Runs Python scripts from its folder; calls python3; needs OPENAI_API_KEY

What it does

Gpt Image Skill is an agent skill from feiskyer/codex-settings. Generate or edit images when the user names OpenAI, GPT Image, or a gpt-image model. Use the default image skill when no provider is named.

Its SKILL.md is about 570 tokens, which your agent loads only when the skill is triggered. The skill folder holds 8 other files (for example `agents/openai.yaml`, `evals/evals.json` and `gpt_image.py`).

It sits in Media & Creative, covering Image generation and Image editing. It works with OpenAI and Python. The repository describes itself as: Curated skills, profiles, and config templates that supercharge Codex CLI — multi-model, deep research, image gen & browser automation. The licence is MIT.

When your agent uses it

  • A gpt-image model
  • Tasks that involve Image generation
  • Tasks that involve Image editing

Example prompts

  • “/gpt-image-skill”

Requirements

  • Python 3
  • A credential in OPENAI_API_KEY

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. OPENAI_API_KEY in ~/.gpt-image.env or the shell environment.
  2. OPENAI_API_BASE (optional) for compatible endpoints such as Azure OpenAI or a proxy, in the same places.
  3. Python dependencies: python3 -m pip install -r "/requirements.txt".
  4. Executable: /gpt_image.py.

What it can do on your machine

Read from SKILL.md and the folder at commit d7f6570. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships script files (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • OPENAI_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Gpt Image Skill loads about 572 tokens when it runs. Until then it costs about 39 tokens; SKILL.md has 253 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~39
When it runs · the whole SKILL.md, loaded when a task matches
~572

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from feiskyer/codex-settings at commit d7f6570, republished under its MIT licence (© feiskyer). 253 words, ~572 tokens.

Download SKILL.mdSave it as .claude/skills/gpt-image-skill/SKILL.md (or your agent's skills folder). This skill also uses 5 other files; get the full folder from GitHub.
name
gpt-image-skill
description
Generate or edit images when the user names OpenAI, GPT Image, or a gpt-image model. Use the default image skill when no provider is named.

GPT Image Skill

Generate or edit images with OpenAI's GPT Image models through the bundled gpt_image.py.

Resolve the skill directory

Before running any command, resolve the absolute directory containing this SKILL.md and refer to it as <skill-dir>. Never assume the current working directory is the skill directory. Keep user input and output paths relative to the user's working directory unless the user requests another location.

Requirements

  1. OPENAI_API_KEY in ~/.gpt-image.env or the shell environment.
  2. OPENAI_API_BASE (optional) for compatible endpoints such as Azure OpenAI or a proxy, in the same places.
  3. Python dependencies: python3 -m pip install -r "<skill-dir>/requirements.txt".
  4. Executable: <skill-dir>/gpt_image.py.

Run it

Generate:

bash
python3 "<skill-dir>/gpt_image.py" --prompt "Modern minimalist logo for a tech startup" \
  --quality high --background transparent --output "logo.png"

Edit or combine references:

bash
python3 "<skill-dir>/gpt_image.py" edit --prompt "Add a rainbow in the sky" \
  --input photo.png --output "photo-with-rainbow.png"

edit accepts several --input files to composite multiple references into one image.

Options live on the subcommands, so read them with generate --help or edit --help — the bare python3 "<skill-dir>/gpt_image.py" --help only lists the two modes. That is where the current --model, --size, --quality, --format, --background, and --n values are; every one has a working default, so pass only what the request actually constrains. Parent directories in the output path are created automatically, and an omitted --format is inferred from the .png, .jpg/.jpeg, or .webp extension, defaulting to PNG.

Report the saved path when the run completes.

When a run fails

Check that OPENAI_API_KEY is set and, for a custom endpoint, that OPENAI_API_BASE is correct; confirm input images exist and are readable, the output directory is writable, and the model name is valid. Do not report success unless an image was saved locally.

© feiskyer, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 5 other files in skills/gpt-image-skill of feiskyer/codex-settings.

  • SKILL.md
  • agents/openai.yaml
  • evals/evals.json
  • gpt_image.py
  • requirements.txt
  • tests/test_gpt_image.py

Open the folder on GitHubat commit d7f6570

Compare with similar skills

Gpt Image Skill next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Gpt Image Skill compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Gpt Image Skill this skillfeiskyer/codex-settings244—~572Automated safety check: PassMIT
Photo Abstract Editorialkwhi6693-web/photo-abstract-editorial113—~870Automated safety check: PassAGPL-3.0
Codex API Image Generatoryc-duan/api-image101—~4.9kAutomated safety check: PassMIT
Stable Diffusion with DiffusersOrchestra-Research/AI-Research-SKILLs13k5 repos~3.2kAutomated safety check: PassMIT
AI Image Creatorevolution-foundation/evo-nexus545—~5.1kAutomated safety check: NotesCustom licence
Generate ImageK-Dense-AI/claude-scientific-writer2.4k1 repos~3.8kAutomated safety check: NotesMIT

Similar skills

  • Photo Abstract Editorial

    kwhi6693-web/photo-abstract-editorial

    A skill your agent uses when one or more photographs must become adaptive photo-plus-abstraction editorial compositions while source facts, spatial relationships, and strict photo preservation…

    113 GitHub stars~870 tokensUpdated 1 mo ago
    Media & CreativeAuto-check passed
  • Codex API Image Generator

    yc-duan/api-image

    Replaces Codex's built-in image tool with provider-based generation and editing, fetching reference images first whenever visual accuracy actually matters.

    101 GitHub stars~4.9k tokensUpdated 5 mo ago
    Media & CreativeAuto-check passed
  • Stable Diffusion with Diffusers

    Orchestra-Research/AI-Research-SKILLs

    Generates and edits images with Stable Diffusion through Hugging Face Diffusers, covering text-to-image, image-to-image, inpainting, SDXL and custom pipelines.

    13k GitHub starsUsed in 5 repos~3.2k tokens
    Media & CreativeAuto-check passed
  • AI Image Creator

    evolution-foundation/evo-nexus

    Generates PNG images through OpenRouter models, with transparent backgrounds and reference-image edits, and describes existing images with multimodal vision.

    545 GitHub stars~5.1k tokensUpdated 4 mo ago
    Media & CreativeAuto-check: notes
  • Generate Image

    K-Dense-AI/claude-scientific-writer

    Generate or edit images with AI models through the OpenRouter Image API (Gemini, Seedream, Recraft, GPT-Image, Riverflow).

    2.4k GitHub starsUsed in 1 repo~3.8k tokens
    Media & CreativeAuto-check: notes
  • Image Gen

    nicknisi/claude-plugins

    Generate or edit images via Google Gemini (nano-banana-pro) or OpenAI gpt-image-2.

    114 GitHub stars~502 tokensUpdated 2 mo ago
    Media & CreativeAuto-check passed

More from feiskyer/codex-settings

All 11 skills in this repo
  • Youtube Transcribe Skill

    feiskyer/codex-settings

    Extract subtitles or a transcript from a YouTube URL and save normalized timestamped text locally.

    244 GitHub stars~745 tokensUpdated 12 days ago
    Auto-check passed
  • Claude Skill

    feiskyer/codex-settings

    Delegate a task to the Claude Code CLI, typically a headless claude -p run.

    244 GitHub stars~742 tokensUpdated 12 days ago
    Auto-check passed
  • Minimax Image Skill

    feiskyer/codex-settings

    Generate images when the user names MiniMax or image-01/image-01-live.

    244 GitHub stars~495 tokensUpdated 12 days ago
    Auto-check passed
  • Code Simplifier

    feiskyer/codex-settings

    Simplify existing code for clarity and maintainability without changing behavior.

    244 GitHub stars~521 tokensUpdated 12 days ago
    Auto-check passed
  • Deep Research

    feiskyer/codex-settings

    用 Codex CLI 子任务完成多来源深度调研并综合成带出处的报告。用于确实需要分头取证的研究,不用于单次查证或已给定材料的总结。

    244 GitHub stars~302 tokensUpdated 12 days ago
    Auto-check passed
  • Nanobanana Skill

    feiskyer/codex-settings

    Generate, edit, or composite images with Gemini/Nanobanana. An agent skill from feiskyer/codex-settings.

    244 GitHub stars~1.2k tokensUpdated 12 days ago
    Auto-check passed

Works with

Questions about Gpt Image Skill

What does Gpt Image Skill do?

Generate or edit images when the user names OpenAI, GPT Image, or a gpt-image model. Gpt Image Skill is an agent skill from feiskyer/codex-settings. Generate or edit images when the user names OpenAI, GPT Image, or a gpt-image model.

When should I use Gpt Image Skill?

Gpt Image Skill fits situations like: A gpt-image model; tasks that involve Image generation; tasks that involve Image editing.

How do I install Gpt Image Skill in Claude Code?

Run `npx skills add feiskyer/codex-settings --skill gpt-image-skill -a claude-code`. Or copy the skill folder (skills/gpt-image-skill in feiskyer/codex-settings) into .claude/skills/gpt-image-skill in your project. Claude Code loads it when a task matches its description.

How do I install Gpt Image Skill in Codex?

Run `npx skills add feiskyer/codex-settings --skill gpt-image-skill -a codex`. Or copy the skill folder (skills/gpt-image-skill in feiskyer/codex-settings) into .agents/skills/gpt-image-skill in your project. Codex loads it when a task matches its description.

Can I use Gpt Image Skill in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add feiskyer/codex-settings --skill gpt-image-skill -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/gpt-image-skill, .gemini/skills/gpt-image-skill, .github/skills/gpt-image-skill and .opencode/skills/gpt-image-skill in your project.

What does Gpt Image Skill need to run?

Going by SKILL.md and its folder, Gpt Image Skill needs Python for the scripts in its folder, the command-line tools its instructions call (python3) and credentials named OPENAI_API_KEY. Our summary lists: Python 3; A credential in OPENAI_API_KEY.

Does Gpt Image Skill access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Gpt Image Skill safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Gpt Image Skill use?

Gpt Image Skill is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Gpt Image Skill use?

About 572 tokens (SKILL.md is roughly 2.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Gpt Image Skill?

Skills that share tags, products or a category with Gpt Image Skill: Photo Abstract Editorial (kwhi6693-web/photo-abstract-editorial, 113 stars), Codex API Image Generator (yc-duan/api-image, 101 stars), Stable Diffusion with Diffusers (Orchestra-Research/AI-Research-SKILLs, 13k stars) and AI Image Creator (evolution-foundation/evo-nexus, 545 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Gpt Image Skill?

feiskyer (a GitHub user) maintains it in feiskyer/codex-settings, which has 244 GitHub stars. The repository holds 11 skills in this directory. The repository was last updated on September 27, 2026.

Source: feiskyer/codex-settings on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.