New: 97,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Codex Image Plugin

by hashgraph-online in hashgraph-online/awesome-codex-plugins

Generate or edit raster images through an OpenAI-compatible image API.

Apache-2.0Auto-check passedAI & LLM Engineering

Install Codex Image Plugin

skills CLI
$ npx skills add hashgraph-online/awesome-codex-plugins --skill codex-image-plugin -a claude-code

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

GitHub CLI
$ gh skill install hashgraph-online/awesome-codex-plugins codex-image-plugin --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/hashgraph-online/awesome-codex-plugins.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/zlsbksdxl/codex-image-plugin/skills/codex-image-plugin .claude/skills/codex-image-plugin && 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
codex-image-plugin
GitHub stars
1.2k
Token cost
~852 tokens
SKILL.md length
320 words
Files
3 (incl. scripts)
Skills in repo
736
Repo updated
First seen
Licence
Apache-2.0

At a glance

Generate or edit raster images through an OpenAI-compatible image API.

  • Works in 5 steps: Decide whether the request is models,… → If the user supplied a URL and key, pass… → Use models to inspect the endpoint… → …
  • The user provides an image API URL and key
  • SKILL.md covers Workflow, List available models, Generate with any selected model and Edit one or more images, plus 1 more section
  • Runs Python scripts from its folder; calls python3; needs OPENAI_API_KEY

What it does

Codex Image Plugin is an agent skill from hashgraph-online/awesome-codex-plugins. Generate or edit raster images through an OpenAI-compatible image API. Use when the user provides an image API URL and key, asks to use a configured image model, lists available image models, or requests new images, reference-image edits, compositing, masks, cleanup, mockups, or illustrations.

Its SKILL.md is about 850 tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including scripts (for example `agents/openai.yaml` and `scripts/image.py`).

It sits in AI & LLM Engineering. It works with OpenAI. The repository describes itself as: A curated list of awesome OpenAI Codex / ChatGPT plugins, skills, and resources. The 1 Codex Marketplace. See live plugins at: https://hol.org/plugins/best-codex-plugins. The licence is Apache-2.0.

When your agent uses it

  • The user provides an image API URL and key
  • Asks to use a configured image model
  • Lists available image models
  • Requests new images

Example prompts

  • “/codex-image-plugin”

Requirements

  • Python 3
  • A credential in OPENAI_API_KEY

Workflow steps

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

  1. Decide whether the request is models, generate, or edit.
  2. If the user supplied a URL and key, pass them with --base-url and --api-key or use environment variables. Prefer environment variables…
  3. Use models to inspect the endpoint before choosing a model.
  4. For edits, obtain the actual input files first. Keep source images unchanged and write new results by default.
  5. Save user-facing results under outputs/ unless the user requests another path, then inspect the result and report exact paths.

What it can do on your machine

Read from SKILL.md and the folder at commit 16b4156. 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 1 file in scripts/ (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

Codex Image Plugin loads about 852 tokens when it runs. Until then it costs about 78 tokens; SKILL.md has 320 words of instructions outside code blocks.

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

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); the scripts in this folder are not scanned.

SKILL.md

The full file from hashgraph-online/awesome-codex-plugins at commit 16b4156, republished under its Apache-2.0 licence (© hashgraph-online). 320 words, ~852 tokens.

Download SKILL.mdSave it as .claude/skills/codex-image-plugin/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
codex-image-plugin
description
Generate or edit raster images through an OpenAI-compatible image API. Use when the user provides an image API URL and key, asks to use a configured image model, lists available image models, or requests new images, reference-image edits, compositing, masks, cleanup, mockups, or illustrations.

Codex Image Plugin

Use scripts/image.py as the API wrapper. It accepts an explicit endpoint URL, API key, and model, or reads them from OPENAI_BASE_URL/OPENAI_API_KEY/IMAGE_MODEL and the active Codex provider in ~/.codex/config.toml (base_url, OPENAI_API_KEY, image_model). The selected --model is passed through unchanged, so the endpoint can expose any compatible image model. Do not print, persist, or reuse a Codex session bearer token as an image API key.

Workflow

  1. Decide whether the request is models, generate, or edit.
  2. If the user supplied a URL and key, pass them with --base-url and --api-key or use environment variables. Prefer environment variables when the key should not appear in shell history.
  3. Use models to inspect the endpoint before choosing a model.
  4. For edits, obtain the actual input files first. Keep source images unchanged and write new results by default.
  5. Save user-facing results under outputs/ unless the user requests another path, then inspect the result and report exact paths.

List available models

bash
python3 <plugin-root>/skills/codex-image-plugin/scripts/image.py models \
  --base-url "https://api.example.com/v1" \
  --api-key "$OPENAI_API_KEY" \
  --image-only

The command prints model IDs only; it never prints the key.

Generate with any selected model

bash
python3 <plugin-root>/skills/codex-image-plugin/scripts/image.py generate \
  --base-url "https://api.example.com/v1" \
  --api-key "$OPENAI_API_KEY" \
  --model "gpt-image-2" \
  --prompt "A clean product photo of a ceramic mug on a white studio background" \
  --out outputs/mug.png \
  --quality high \
  --size 1024x1024 \
  --force

--model is not hardcoded. gpt-image-2 is only an example; use an ID returned by models or the model name documented by the endpoint.

Edit one or more images

bash
python3 <plugin-root>/skills/codex-image-plugin/scripts/image.py edit \
  --base-url "https://api.example.com/v1" \
  --api-key "$OPENAI_API_KEY" \
  --model "gpt-image-2" \
  --image work/input.png \
  --prompt "Change only the background. Preserve the subject exactly: same shape, pose, proportions, colors, lighting, and details." \
  --out outputs/edited.png \
  --force

Repeat --image for multiple references. Use --mask mask.png for localized edits. A mask must be a PNG with alpha: transparent pixels are editable and opaque pixels are preserved. --mask-ring creates a temporary ring mask for a square image.

Prompting and validation

Separate mutable and protected content. For a localized edit, describe exactly what may change and preserve the subject's shape, pose, proportions, colors, lighting, and details. For a new image, specify the asset type, subject, setting, composition, style, lighting, exact text, and constraints. Use --dry-run to validate a request without making an API call. Model-specific limits such as supported sizes, masks, formats, or transparency are determined by the endpoint; report API errors without hiding them.

© hashgraph-online, Apache-2.0. 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 2 other files (scripts) in plugins/zlsbksdxl/codex-image-plugin/skills/codex-image-plugin of hashgraph-online/awesome-codex-plugins.

  • SKILL.md
  • agents/openai.yaml
  • scripts/image.py

Open the folder on GitHubat commit 16b4156

Compare with similar skills

Codex Image Plugin 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.

Codex Image Plugin compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Codex Image Plugin this skillhashgraph-online/awesome-codex-plugins1.2k—~852Automated safety check: PassApache-2.0
Chroma Vector DatabaseOrchestra-Research/AI-Research-SKILLs13k8 repos~2.3kAutomated safety check: PassMIT
CLIP Image-Text MatchingOrchestra-Research/AI-Research-SKILLs13k8 repos~1.7kAutomated safety check: PassMIT
Codebase Managementgiancarloerra/SocratiCode3.3k1 repos~1.8kAutomated safety check: PassAGPL-3.0
Azure AI Projects Python SDKmicrosoft/skills3.1k6 repos~2.8kAutomated safety check: PassMIT
Fine-Tuning ExpertJeffallan/claude-skills12k1 repos~1.7kAutomated safety check: PassMIT

Similar skills

  • Chroma Vector Database

    Orchestra-Research/AI-Research-SKILLs

    Shows how to store documents and embeddings in Chroma, query them by similarity with metadata filters, and persist them to disk for RAG and semantic search projects.

    13k GitHub starsUsed in 8 repos~2.3k tokens
    AI & LLM EngineeringAuto-check passed

  • CLIP Image-Text Matching

    Orchestra-Research/AI-Research-SKILLs

    Explains OpenAI's CLIP model for zero-shot image classification, image-text similarity, semantic image search and content moderation, with install steps and code patterns.

    13k GitHub starsUsed in 8 repos~1.7k tokens
    AI & LLM EngineeringAuto-check passed

  • Codebase Management

    giancarloerra/SocratiCode

    Set up, index, and manage SocratiCode codebase indexing. An agent skill from giancarloerra/SocratiCode.

    3.3k GitHub starsUsed in 1 repo~1.8k tokens
    AI & LLM EngineeringAuto-check passed

  • Azure AI Projects Python SDK

    microsoft/skills

    Official

    Reference for building on Microsoft Foundry with the azure-ai-projects Python SDK: project clients, versioned agents, evaluations, connections, datasets and indexes.

    3.1k GitHub starsUsed in 6 repos~2.8k tokens
    AI & LLM EngineeringAuto-check passed

  • Fine-Tuning Expert

    Jeffallan/claude-skills

    Guides LLM fine-tuning with LoRA and QLoRA through Hugging Face PEFT, from dataset validation and training checks to adapter merging, quantization and deployment.

    12k GitHub starsUsed in 1 repo~1.7k tokens
    AI & LLM EngineeringAuto-check passed

  • Docs Planner

    strands-agents/harness-sdk

    Identify documentation gaps and prioritize the docs backlog.

    8.7k GitHub stars~821 tokensUpdated yesterday
    AI & LLM EngineeringAuto-check passed

More from hashgraph-online/awesome-codex-plugins

All 736 skills in this repo

  • Anime Reaction Gif

    hashgraph-online/awesome-codex-plugins

    Create original anime-style reaction stickers as looping GIFs and MP4 previews, using generated character pose sheets and timed key poses.

    1.2k GitHub stars~922 tokensUpdated yesterday
    Auto-check passed

  • Calibredb

    hashgraph-online/awesome-codex-plugins

    Manage and query Calibre libraries with the calibredb CLI (local paths or Calibre Content server URLs).

    1.2k GitHub stars~1k tokensUpdated yesterday
    Auto-check passed

  • Rust API Test Harness

    hashgraph-online/awesome-codex-plugins

    A skill your agent uses when adding, changing, testing, or debugging Rust HTTP APIs and services, especially when Codex needs black-box integration tests, random-port app startup, real database test…

    1.2k GitHub stars~1.7k tokensUpdated yesterday
    Auto-check passed

  • Art

    hashgraph-online/awesome-codex-plugins

    Make a studio's game look like something at build time — a cover from a real frame of the game (free), painted covers, backdrops, textures and character plates from image models through the…

    1.2k GitHub stars~2.4k tokensUpdated yesterday
    Auto-check passed

  • Calle

    hashgraph-online/awesome-codex-plugins

    Use CALL-E from Codex through the calle CLI. An agent skill from hashgraph-online/awesome-codex-plugins.

    1.2k GitHub stars~2.9k tokensUpdated yesterday
    Auto-check passed

  • Game Balance Economy

    hashgraph-online/awesome-codex-plugins

    Balance game difficulty, resources, rewards, probability, progression, economies, and dominant strategies.

    1.2k GitHub stars~618 tokensUpdated yesterday
    Auto-check passed

Works with

Categories

Questions about Codex Image Plugin

What does Codex Image Plugin do?

Generate or edit raster images through an OpenAI-compatible image API. Codex Image Plugin is an agent skill from hashgraph-online/awesome-codex-plugins. Generate or edit raster images through an OpenAI-compatible image API.

When should I use Codex Image Plugin?

Codex Image Plugin fits situations like: the user provides an image API URL and key; asks to use a configured image model; lists available image models; requests new images.

How do I install Codex Image Plugin in Claude Code?

Run `npx skills add hashgraph-online/awesome-codex-plugins --skill codex-image-plugin -a claude-code`. Or copy the skill folder (plugins/zlsbksdxl/codex-image-plugin/skills/codex-image-plugin in hashgraph-online/awesome-codex-plugins) into .claude/skills/codex-image-plugin in your project. Claude Code loads it when a task matches its description.

How do I install Codex Image Plugin in Codex?

Run `npx skills add hashgraph-online/awesome-codex-plugins --skill codex-image-plugin -a codex`. Or copy the skill folder (plugins/zlsbksdxl/codex-image-plugin/skills/codex-image-plugin in hashgraph-online/awesome-codex-plugins) into .agents/skills/codex-image-plugin in your project. Codex loads it when a task matches its description.

Can I use Codex Image Plugin 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 hashgraph-online/awesome-codex-plugins --skill codex-image-plugin -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/codex-image-plugin, .gemini/skills/codex-image-plugin, .github/skills/codex-image-plugin and .opencode/skills/codex-image-plugin in your project.

What does Codex Image Plugin need to run?

Going by SKILL.md and its folder, Codex Image Plugin 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 Codex Image Plugin 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 Codex Image Plugin 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Codex Image Plugin use?

Codex Image Plugin is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Codex Image Plugin use?

About 852 tokens (SKILL.md is roughly 3.4k 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 Codex Image Plugin?

Skills that share tags, products or a category with Codex Image Plugin: Chroma Vector Database (Orchestra-Research/AI-Research-SKILLs, 13k stars), CLIP Image-Text Matching (Orchestra-Research/AI-Research-SKILLs, 13k stars), Codebase Management (giancarloerra/SocratiCode, 3.3k stars) and Azure AI Projects Python SDK (microsoft/skills, 3.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Codex Image Plugin?

hashgraph-online (a GitHub organization) maintains it in hashgraph-online/awesome-codex-plugins, which has 1,232 GitHub stars. The repository holds 736 skills in this directory. The repository was last updated on October 6, 2026.

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