gpt-image-2-skill
Скилл и CLI на Rust: агент генерирует и правит картинки через GPT Image 2, делает прозрачный PNG и отвечает в JSON.
- 146 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Промпты и входные картинки уходят выбранному провайдеру, вход через Codex использует его учетные данные.
- Ключи API читаются из окружения, Keychain или файла конфигурации.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/gpt-image-2-skillОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Промпты и входные картинки уходят выбранному провайдеру, вход через Codex использует его учетные данные.
- Ключи API читаются из окружения, Keychain или файла конфигурации.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Репозиторий выпускает один Rust-движок в четырех видах: CLI `gpt-image-2-skill`, настольное приложение, веб-сервис для Docker и скилл для Claude Code. Скилл вызывает CLI через обертку на Node, а тот обращается к `gpt-image-2` у OpenAI, к совместимому API с другим адресом или к входу Codex. Каждая команда возвращает JSON с полем `ok` и машинно читаемым кодом ошибки, а ход работы идет строками JSONL в `stderr`. Есть генерация и правка по маске, размеры до 4K и конвейер прозрачного PNG: картинка рисуется на контрольном фоне, а затем фон вырезается локально.
Для кого. Разработчикам и дизайнерам, которые поручают агенту делать иллюстрации, иконки и ассеты с прозрачным фоном прямо из терминала.
Подходит, если
- Агент рисует иллюстрацию или обложку в ходе работы над проектом.
- Нужен логотип или иконка на прозрачном фоне с проверкой качества выреза.
- Картинку правят по маске, не трогая остальное изображение.
- Скрипт или CI вызывает генерацию и разбирает ответ по JSON.
Не подходит, если
- Нет ключа OpenAI, совместимого API или входа Codex.
- Нужны модели генерации картинок не от OpenAI.
- Ключи нельзя хранить на машине, где запускается агент.
Пример запроса к агенту
Нарисуй иконку красного яблока на прозрачном фоне, размер 2K, сохрани в `./apple.png` и проверь качество выреза.Ограничения
Генерация платная и идет по тарифу выбранного провайдера. Вход через `~/.codex/auth.json` повторно использует учетные данные Codex, проверьте условия своей подписки. Бинарный файл скилл при необходимости скачивает из релизов GitHub. Ключи читаются из окружения, Keychain или файла, храните их отдельно от репозитория. История и конфиг лежат в `$CODEX_HOME/gpt-image-2-skill/`. Для четырех поверхностей нужен общий движок: версия бинарного файла должна совпадать с версией скилла. Установка через Homebrew и Cargo требует соответствующих менеджеров пакетов.
Как отключить. Удалите `~/.claude/skills/gpt-image-2-skill` и, если ставили, глобальный пакет командой `npm uninstall -g gpt-image-2-skill`. Конфиг и историю очистите в `$CODEX_HOME/gpt-image-2-skill/`.
Частые вопросы
Какие провайдеры поддерживаются?
Три: OpenAI с моделью `gpt-image-2`, совместимый API через `--openai-api-base` и Codex с файлом `auth.json`. Команды одинаковы, меняется только флаг `--provider`.
Как получить прозрачный PNG?
Командами `transparent generate`, `transparent extract` и `transparent verify`. Фон вырезается локально и проверяется по профилям качества, встроенная прозрачность провайдера не нужна.
Как установить скилл?
Командой `npx skills add` из README или копированием папки `skills/gpt-image-2-skill` в `~/.claude/skills/`.
Нужен ли отдельный бинарный файл?
Нет, обертка скилла сама ищет бинарный файл в нескольких местах и при отсутствии скачивает нужную версию из релизов.
Можно ли править картинку по маске?
Да. Команда `images edit` принимает исходное изображение и маску, остальная часть картинки не меняется. Точный набор флагов смотрите в `--help`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
СкиллыСкилл и CLI для генерации и правки изображений через GPT Image 2 и 2.5 с библиотекой готовых промптов
Claude Image (GPT Image 2)
claude-image
Скилл учит агентов работать с GPT Image 2. Нужен доступ к API OpenAI, который из России без обходных путей недоступен. README на китайском и английском
Библиотека стилей GPT-Image2
gpt-image-2-style-library
Скилл подбирает готовый шаблон и стиль из библиотеки кейсов GPT-Image2 и собирает из него законченный промпт
Sprite Gen
sprite-gen
Скилл для Codex и Claude и Python CLI: из одного базового изображения строит спрайты 2D-игры, убирает фон и собирает атласы анимации
Скилл для Claude Code собирает из короткой просьбы готовый промпт для gpt-image-2 и проверяет его скриптом
Генерация и правка картинок из любого агента: CLI imagegen-agent и скилл с библиотекой промптов Codex для совместимых API
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| gpt-image-2-skill (эта карточка) | нет | 146 | |
| GPT-Image2-Skill | нет | 6 011 | другой скилл для `gpt-image-2`; здесь отдельный Rust CLI с JSON-протоколом и тремя провайдерами |
| GPT Image 2 Prompts от YouMind | нет | 10 243 | сборник готовых промптов; здесь инструмент запускает генерацию и правку сам |
Коротко о README
Скилл только пересылает аргументы в Rust-движок, так что CLI, приложение и веб-версия дают одинаковый результат. Подробности про хранение результатов и вебхуки относятся к приложению и Docker-версии.