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

gpt-image-skill — скилл для Claude Code: генерация изображений

Создаёт и редактирует изображения через OpenAI GPT Image API. Скилл срабатывает, когда вы явно просите OpenAI или GPT; для схем он не предназначен.

MIT 156 установок ★ 1 682 обновлён 2026-09-27

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add feiskyer/claude-code-settings --skill gpt-image-skill -a claude-code
Открыть на GitHub

Что делает gpt-image-skill

Скилл запускает Python-скрипт gpt_image.py: он создаёт изображение по текстовому описанию или редактирует существующее. Для правки можно передать до 3 входных изображений. Доступны модели GPT Image, выбор размера, качества, формата и фона; результат сохраняется по указанному пути или под автоматически созданным именем.

Нужны OPENAI_API_KEY, Python 3 и библиотеки openai и Pillow. Ключ задают в ~/.gpt-image.env или через переменную окружения; зависимости устанавливают из requirements.txt. Можно указать свой OPENAI_API_BASE для совместимого API. Без ключа запросы к API не выполнятся. Скилл рассчитан на запросы с явным упоминанием OpenAI или GPT, а схемы предлагает создавать через Mermaid или код.

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

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

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

  • Создай изображение обложки по этому описанию и сохрани как cover.png через OpenAI GPT.
  • Отредактируй photo.png: добавь радугу и сохрани результат как edited.png с помощью GPT.
  • Объедини item1.png, item2.png и item3.png в одну композицию через OpenAI.

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

1Через Skills CLI (Vercel)

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

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

~/.claude/skills/gpt-image-skill/SKILL.md

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

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

Вопросы о gpt-image-skill

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

Выполните npx skills add feiskyer/claude-code-settings --skill gpt-image-skill -a claude-code. Файл скилла появится по пути ~/.claude/skills/gpt-image-skill/SKILL.md.

Что делает gpt-image-skill?

Он создаёт изображения через OpenAI GPT Image API и редактирует изображения по текстовой инструкции. Запускает для этого скрипт gpt_image.py.

Что нужно для работы gpt-image-skill?

Нужны OPENAI_API_KEY, Python 3 и библиотеки openai и Pillow. Для редактирования также нужны доступные файлы изображений.

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

SKILL.md · MIT
---
name: gpt-image-skill
description: 'Generate or edit images using OpenAI GPT Image API (gpt-image-2, gpt-image-1, etc). Use ONLY when the user explicitly names OpenAI or GPT as the provider: "gpt image", "openai image", "generate image with openai", "用 openai 画图", "用 GPT 生成图片". For generic image requests without a provider, use nanobanana-skill instead. Do NOT use for diagrams (架构图/流程图) — draw those with Mermaid or code.'
allowed-tools: Read, Write, Glob, Grep, Task, Bash(cat:*), Bash(ls:*), Bash(tree:*), Bash(python3:*)
---

# GPT Image Skill

Generate or edit images using OpenAI's GPT Image models through a bundled Python script.

## Requirements

1. **OPENAI_API_KEY**: Must be configured in `~/.gpt-image.env` or `export OPENAI_API_KEY=<your-key>`
2. **OPENAI_API_BASE** (optional): Custom API base URL for compatible endpoints (e.g. Azure OpenAI, proxies). Set in `~/.gpt-image.env` or export it.
3. **Python3 with dependencies**: openai, Pillow. Install via `python3 -m pip install -r ${CLAUDE_SKILL_DIR}/requirements.txt` if not installed yet.
4. **Executable**: `${CLAUDE_SKILL_DIR}/gpt_image.py`

## Instructions

### For image generation

1. Ask the user for:
   - What they want to create (the prompt)
   - Desired size (optional, defaults to 1024x1024)
   - Output filename (optional, auto-generates UUID-based name if not specified)
   - Model preference (optional, defaults to gpt-image-2)
   - Quality (optional, defaults to auto)
   - Number of images (optional, defaults to 1)

2. Run the script:

   ```bash
   python3 ${CLAUDE_SKILL_DIR}/gpt_image.py --prompt "description of image" --output "filename.png"
   ```

3. Show the user the saved image path when complete.

### For image editing

1. Ask the user for:
   - Input image file(s) to edit (up to 3)
   - What changes they want (the prompt)
   - Output filename (optional)

2. Run with input images:

   ```bash
   python3 ${CLAUDE_SKILL_DIR}/gpt_image.py edit --prompt "editing instructions" --input image1.png image2.png --output "edited.png"
   ```

## Available Options

### Models (--model)

- `gpt-image-2` (default) — Latest model with strong instruction following, text rendering, and broad world knowledge
- `gpt-image-1.5` — Mid-tier model
- `gpt-image-1` — First-generation GPT image model
- `gpt-image-1-mini` — Lightweight, faster generation

### Sizes (--size)

- `1024x1024` (default) — Square
- `1024x1536` — Portrait (2:3)
- `1536x1024` — Landscape (3:2)
- `auto` — Let the model decide

### Quality (--quality)

- `auto` (default) — Model decides optimal quality
- `high` — Higher detail, slower
- `medium` — Balanced
- `low` — Fastest

### Output Format (--format)

- `png` (default) — Lossless
- `jpeg` — Smaller file size
- `webp` — Modern format, good compression

### Background (--background)

- `auto` (default) — Model decides
- `transparent` — Transparent background (png/webp only)
- `opaque` — Solid background

### Other Options

- `--n <count>` — Number of images to generate (default: 1)
- `--output <filename>` — Output filename (default: auto-generated)

## Examples

### Generate a simple image

```bash
python3 ${CLAUDE_SKILL_DIR}/gpt_image.py --prompt "A serene mountain landscape at sunset with a lake"
```

### Generate with specific size and output

```bash
python3 ${CLAUDE_SKILL_DIR}/gpt_image.py \
  --prompt "Modern minimalist logo for a tech startup" \
  --size 1024x1024 \
  --quality high \
  --output "logo.png"
```

### Generate landscape image

```bash
python3 ${CLAUDE_SKILL_DIR}/gpt_image.py \
  --prompt "Futuristic cityscape with flying cars" \
  --size 1536x1024 \
  --output "cityscape.png"
```

### Generate with transparent background

```bash
python3 ${CLAUDE_SKILL_DIR}/gpt_image.py \
  --prompt "A cute cartoon cat mascot" \
  --background transparent \
  --format png \
  --output "mascot.png"
```

### Generate multiple images

```bash
python3 ${CLAUDE_SKILL_DIR}/gpt_image.py \
  --prompt "Abstract art in the style of Kandinsky" \
  --n 3 \
  --output "art.png"
```

### Edit existing images

```bash
python3 ${CLAUDE_SKILL_DIR}/gpt_image.py edit \
  --prompt "Add a rainbow in the sky" \
  --input photo.png \
  --output "photo-with-rainbow.png"
```

### Combine multiple reference images

```bash
python3 ${CLAUDE_SKILL_DIR}/gpt_image.py edit \
  --prompt "Create a gift basket containing all items shown" \
  --input item1.png item2.png item3.png \
  --output "gift-basket.png"
```

### Use a different model

```bash
python3 ${CLAUDE_SKILL_DIR}/gpt_image.py \
  --prompt "Detailed portrait of a cat in watercolor style" \
  --model gpt-image-1 \
  --output "cat-portrait.png"
```

## Error Handling

If the script fails:

- Check that `OPENAI_API_KEY` is exported
- If using a custom endpoint, verify `OPENAI_API_BASE` is correct
- Verify input image files exist and are readable (for editing)
- Ensure the output directory is writable
- Check that the model name is valid

## Best Practices

1. Be descriptive in prompts — include style, mood, colors, composition details
2. For logos/icons, use square size (1024x1024) with transparent background
3. For social media, use portrait (1024x1536) for stories or square for posts
4. For wallpapers/headers, use landscape (1536x1024)
5. Use `high` quality for final output, `auto` for quick iterations
6. GPT Image models excel at text rendering — include text in prompts when needed
7. For editing, provide clear instructions about what to change and what to keep

© feiskyer · MIT · feiskyer/claude-code-settings

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

Все скиллы по теме «Дизайн» →
gpt-image wuyoscar Генерирует и редактирует изображения через CLI, по умолчанию используя GPT Image 2.6 Flare. CX Codex +1 613установок gpt-image-v2 eachlabs Скилл gpt-image-v2 для Claude Code создаёт и редактирует изображения через EachLabs с моделями GPT Image v2. CX Codex +1 169установок gpt-image-2 prime-skills Генерирует и редактирует изображения через OpenAI GPT Image 2 на RunComfy. Точно встраивает текст, логотипы и многоязычную типографику — для e-commerce, рекламы и UI-макетов. CX Codex +1 95 100установок gpt-image-1-5 intellectronica Генерирует и редактирует изображения через модель GPT Image 1.5 от OpenAI. Создаёт графику по описанию, заменяет фон и выполняет точечный инпейнтинг по маске. CX Codex +1 625установок gpt-image-edit prime-skills Скилл gpt-image-edit редактирует изображения через GPT Image 2 (/edit endpoint ChatGPT Images 2.0) на RunComfy. Сохраняет лица и объекты, переписывает текст на любых языках (кириллица, иероглифы, арабская вязь), принимает до 10 референсов. CX Codex +1 447 000установок scenario-gpt-image scenario-labs Скилл scenario-gpt-image для Claude Code передаёт через Scenario MCP запросы к моделям GPT Image для генерации и редактирования изображений. Редактирует референсы с помощью масок и создаёт прозрачные вырезки. CX Codex +1 877установок

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

codex-skill Скилл делегирует написание кода и ревью утилите codex exec. Даёт второй взгляд на архитектуру и ведёт автономную работу в изолированной песочнице. CX Codex +1 416установок youtube-transcribe-skill Скилл youtube-transcribe-skill для Claude Code извлекает субтитры из видео YouTube и сохраняет их в текстовый файл с временными метками. Готовит расшифровку без ручного копирования. CX Codex +1 366установок nanobanana-skill Скилл nanobanana-skill для Claude Code генерирует и редактирует изображения через Google Gemini из консоли или редактора. Создаёт графику и дорабатывает готовые картинки по текстовому описанию. CX Codex +1 335установок translate Скилл translate для Claude Code переводит технические статьи и тексты с английского или японского на китайский, сохраняя форматирование и техническую точность. Переводит иностранные материалы на китайский. CX Codex +1 294установок github-fix-issue Скилл github-fix-issue для Claude Code ведёт от чтения задачи GitHub до проверки изменений и отправки pull request через CLI. CX Codex +1 205установок

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

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