К основному содержанию
скилл CX Codex

edit-image — скилл для Claude Code: что делает и как установить

Скилл edit-image редактирует готовые изображения через OpenAI gpt-image-2 и Codex CLI: меняет отдельные детали, цвета палитры или создаёт варианты по образцу.

MIT ★ 195 обновлён 2026-08-10

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add Sateezg/codex-bridge
/plugin install codex-bridge@codex-bridge
Открыть на GitHub

Что делает edit-image

Скилл передаёт исходные файлы в утилиту codex-imagegen с флагом --ref. Модель сохраняет все не упомянутые в запросе детали и записывает итог по новому пути, поэтому исходник остаётся нетронутым. В один запрос разрешено передавать до 4 изображений --ref, разделяя в тексте целевой объект и стилевые примеры.

Команда требует таймаут в Bash не менее 300000 мс. Для фоновой прозрачности скрипт генерирует объект на зелёном фоне #00FF00 и вырезает его через вспомогательный скрипт remove_chroma_key.py, а честная прозрачность требует ключ OPENAI_API_KEY.

Каждая правка расходует квоту плана ChatGPT. Простые задачи вроде кадрирования, сжатия или поворота лучше выполнять через ImageMagick или sips без вызова нейросети.

Какие задачи решает

  • заменить фон или отдельные детали на готовой картинке
  • перекрасить иконки под заданные цвета дизайн-системы
  • сгенерировать новые элементы интерфейса в стиле референса
  • исправить текст на вывеске или этикетке без искажения окружения

Примеры запросов агенту

  • Замени небо на закатное оранжевое в ./assets/hero.png и сохрани в ./out/hero-sunset.png, людей не меняй
  • Перекрась ./assets/icon.png в монохромный цвет #2563EB на белом фоне
  • Сделай иконку настроек в стиле референса ./assets/home.png с той же толщиной линий

Как установить edit-image

1Через маркетплейс плагинов

/plugin marketplace add Sateezg/codex-bridge
/plugin install codex-bridge@codex-bridge

Команда ставит плагин codex-bridge целиком, со всеми его скиллами

2Вручную: положить файлы

~/.claude/skills/edit-image/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/edit-image/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об edit-image

Как установить edit-image в Claude Code?

Подключите каталог и поставьте плагин двумя командами: /plugin marketplace add Sateezg/codex-bridge, а затем /plugin install codex-bridge@codex-bridge.

Что делает скилл edit-image?

Он вызывает модель OpenAI gpt-image-2 через Codex CLI, чтобы точечно изменить исходный файл или собрать похожий ассет без изменения оригинала.

Перезаписывает ли утилита исходный файл?

Оригинал никогда не перезаписывается: утилита всегда создаёт новый файл и выводит его абсолютный путь в терминал.

Исходный текст

SKILL.md · MIT
---
description: Edit, restyle, or vary an EXISTING image file using OpenAI gpt-image-2 through the Codex CLI — change one thing and keep the rest, swap a background, recolor to a brand palette, add or fix text, or produce style-matched variants of a reference image. Use whenever the user points at an image file and asks to change, fix, restyle, clean up, or make a version of it.
---

# Edit an existing image (gpt-image-2 via Codex CLI)

Same wrapper as generation, plus `--ref` to attach the source image:

```bash
codex-imagegen "<what to change>" <output.png> --ref <source.png> [--size WxH]
```

The wrapper attaches the reference with `codex exec -i`, tells Codex to preserve
everything not mentioned, and prints the absolute path of the new file. **The
source file is never modified** — always write to a new path.

## Examples

```bash
# change one thing, keep the rest
codex-imagegen "change the sky to a sunset orange, keep the building and people identical" \
  ./out/hero-sunset.png --ref ./assets/hero.png

# recolor to a brand palette
codex-imagegen "recolor to a monochrome palette of #2563EB on white, keep the exact shapes" \
  ./out/icon-blue.png --ref ./assets/icon.png

# style-matched sibling asset
codex-imagegen "a settings gear icon in exactly the style of the reference: same stroke weight, same palette, same corner radius" \
  ./out/settings.png --ref ./assets/home.png
```

Up to four `--ref` images can be passed — useful when one is the subject and the
others are style references. Say in the prompt which is which.

## Writing the change description

Be surgical. The model preserves what you don't mention, so name the change and
then name what must survive it:

- Good: *"replace the text on the sign with 'OPEN 24/7', keep the font style, lighting and every other element identical"*
- Bad: *"make it better"* — produces an unrelated image

For a series of edits, chain them one at a time (each output becomes the next
`--ref`) rather than stacking five changes into one prompt.

## Rules

1. **Never overwrite the source.** Write to a new file; offer to replace only after
   the user has seen the result. Note that Codex itself resists overwriting — the
   wrapper prints the path actually written, which may be a versioned sibling like
   `out-v2.png`. Use the printed path, not the one you asked for.
2. **Verify by viewing.** Read the output PNG with the Read tool and compare
   against the request before reporting done. Regenerate with a sharper prompt if
   the model drifted — at most 2 retries.
3. **Use a Bash timeout of at least 300000 ms** (5 minutes).
4. **For a transparent result**, regenerate the subject on a flat `#00FF00`
   background (`#FF00FF` if the subject is green) and strip the key with the
   helper Codex ships:
   ```bash
   python "${CODEX_HOME:-$HOME/.codex}/skills/.system/imagegen/scripts/remove_chroma_key.py" \
     --input ./keyed.png --out ./final.png --auto-key border --soft-matte \
     --transparent-threshold 12 --opaque-threshold 220 --despill
   ```
   Verify transparent corners and no colour fringe afterwards. True native
   transparency needs Codex's CLI fallback plus an `OPENAI_API_KEY` — only raise
   that option for hard subjects (hair, fur, glass, smoke) and let the user decide.
5. **Not for precise pixel work.** Cropping, resizing, rotating, format conversion
   and compression are faster and lossless with ImageMagick or `sips` — use those
   directly instead of regenerating.
6. Each edit spends the user's ChatGPT plan quota. Don't loop unprompted.

For multi-image jobs, hand the whole brief to the `codex-artist` subagent instead.

© Sateezg · MIT · Sateezg/codex-bridge

Похожие скиллы

Все скиллы по теме «Дизайн» →
gpt-image-edit prime-skills Скилл gpt-image-edit редактирует изображения через GPT Image 2 (/edit endpoint ChatGPT Images 2.0) на RunComfy. Сохраняет лица и объекты, переписывает текст на любых языках (кириллица, иероглифы, арабская вязь), принимает до 10 референсов. CX Codex +1 447 000установок ai-image-generation 101-skills Скилл ai-image-generation для Claude Code создаёт и редактирует изображения через belt с выбором модели. Создаёт иллюстрации и макеты, обрабатывает готовые изображения. CX Codex +1 1 000 000установок image-edit prime-skills Скилл image-edit для Claude Code выбирает модель RunComfy для редактирования изображений. Заменяет фон, правит текст и выполняет пакетные изменения. CX Codex +1 448 100установок fal-image-edit nexu-io Скилл fal-image-edit подключает редактирование картинок через модели fal.ai. Помогает убирать фон, удалять объекты, переносить стиль и дорисовывать области через инпейнтинг. CX Codex +1 2 900установок eachlabs-image-edit eachlabs Скилл eachlabs-image-edit подключает к агенту больше 130 моделей EachLabs: правка, апскейл, удаление фона, инпейнтинг, смена лиц и анализ картинок. CX Codex +1 807установок gpt-image-2-style-library freestylefly Скилл gpt-image-2-style-library превращает пользовательские идеи в готовые промпты для GPT-Image2 на основе библиотеки стилей awesome-gpt-image-2. Помогает сформировать композицию, теги и негативные ограничения. CX Codex +1 4 200установок

Из того же набора12

Весь набор →
ask-codex Скилл ask-codex для Claude Code отправляет вопрос о текущем репозитории OpenAI Codex (GPT-5) и возвращает ответ без запуска субагента. Для разовых вопросов, второго мнения и поиска багов. CX Codex +1 ★ 195звёзд репо codex-reviewer Субагент codex-reviewer для Claude Code независимо проверяет дифф через OpenAI Codex и сверяет каждую найденную ошибку с реальными файлами. CX Codex ★ 195звёзд репо codex-review Скилл codex-review для Claude Code запускает независимую проверку изменений через OpenAI Codex. Агент подключает его по просьбе проверить код, PR или ветку, а также перед коммитом или слиянием крупного изменения. CX Codex +1 ★ 195звёзд репо codex-debugger Субагент codex-debugger передаёт расследование бага независимому Codex через локальный CLI и сам проверяет его диагноз по коду, прежде чем что-то предложить. CX Codex ★ 195звёзд репо codex-implementer Субагент codex-implementer передаёт Codex объёмные, чётко описанные изменения кода, а затем проверяет diff и результат тестов. Подходит для массовых правок и генерации однотипных файлов. CX Codex ★ 195звёзд репо codex-artist Субагент codex-artist для Claude Code создаёт и редактирует файлы изображений через локальный Codex CLI. Запускается для иконок, логотипов, баннеров, мокапов и наборов ассетов. CX Codex ★ 195звёзд репо asset-set Скилл asset-set собирает фавиконы, иконки приложения, OG-карточки и иллюстрации за один проход: общий стилевой контракт, правильные размеры и имена файлов. CX Codex +1 ★ 195звёзд репо codex-delegate Скилл codex-delegate для Claude Code передаёт Codex объёмные механические задачи и проверяет результат. Массовые правки, генерация тестов и аудит репозитория. CX Codex +1 ★ 195звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой