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

oma-image · first-fluke, oma — скилл для Claude Code: что делает и как установить

Скилл oma-image маршрутизирует генерацию картинок через Codex и Pollinations прямо из редактора с проверкой авторизации и фиксацией манифеста.

MIT ★ 1 472 обновлён 2026-10-29

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

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

Скилл связывает агента с утилитой oma image generate. Он направляет запросы к Codex (модель gpt-image-2 через OAuth ChatGPT) или бесплатному провайдеру Pollinations (flux/zimage). Провайдер Gemini во встроенной конфигурации выключен, так как требует платного аккаунта. Результаты вместе с файлом manifest.json сохраняются в .agents/results/images/.

Перед запуском генерации инструмент проверяет входные данные: если в описании не хватает стиля, ракурса или контекста, он запросит уточнение или покажет дополненный вариант промпта. Поддерживается сравнение нескольких моделей одной командой с флагом --vendor all.

Защитный барьер по расходам требует явного подтверждения, если расчётная стоимость операции достигает $0.20.

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

  • сгенерировать иллюстрации или концепт-арт прямо в терминале
  • сравнить выдачу картинок от разных нейросетей по одному запросу
  • сохранить метаданные промпта и модели в воспроизводимый manifest.json
  • создать изображение на основе локального референс-файла

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

  • Сгенерируй обложку для статьи про микросервисы в неоновом стиле через Pollinations
  • Сделай фото кота в очках, используя Codex и локальный референс ./assets/cat.png
  • Сравни результаты генерации пейзажа марсианской станции по всем доступным моделям

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

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

/plugin marketplace add first-fluke/oh-my-agent
/plugin install oma@oh-my-agent

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

2Через Skills CLI (Vercel)

npx skills add first-fluke/oh-my-agent --skill oma-image -a claude-code

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

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

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

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

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

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

Выполните последовательно две команды: /plugin marketplace add first-fluke/oh-my-agent и затем /plugin install oma@oh-my-agent.

Что делает oma-image?

Принимает текстовое задание, выбирает подходящий сервис генерации, проверяет авторизацию и сохраняет файлы с отчётом воспроизводимости.

Какие провайдеры картинок доступны без оплаты?

По умолчанию сервис Pollinations с моделями flux и zimage работает бесплатно после регистрации.

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

SKILL.md · MIT
---
name: oma-image
description: Multi-vendor AI image generation with authentication-aware parallel dispatch. Routes to Codex (gpt-image-2 via ChatGPT OAuth) and Pollinations (flux/zimage, free with signup). Gemini provider is present but disabled by default (requires billing). Use for image generation, image creation, visual asset generation, and AI art.
---

# Image Agent - Multi-Vendor Image Router

## Scheduling

### Goal
Generate images and visual assets through authenticated multi-vendor routing while preserving prompt clarity, reference-image handling, cost controls, and reproducible output manifests.

### Intent signature
- User asks to generate images, visual assets, illustrations, product photos, concept art, mockups, or AI art.
- Another skill needs shared image-generation infrastructure.
- User provides reference images or asks for vendor comparison.

### When to use

- Generating images, visual assets, illustrations, product photos, concept art
- Comparing output between multiple image models for the same prompt
- Producing images from prompts within editor workflows (Claude Code, Codex, Gemini CLI)
- Other skills needing image generation infrastructure (shared invocation)

### When NOT to use

- Editing an existing image or photo manipulation -> out of scope
- Generating videos or audio -> out of scope
- Inline vector art / SVG composition from structured data -> use a templating skill
- Simple asset resizing or format conversion -> use a dedicated image library

### Expected inputs
- Image prompt or creative brief
- Optional vendor, size, quality, count, output directory, and reference images
- Authentication/environment state for Codex, Pollinations, or Gemini

### Expected outputs
- Generated image files under `.agents/results/images/` or requested output directory
- `manifest.json` with prompt, vendor, model, and reproducibility metadata
- Vendor comparison outputs when `--vendor all` is used

### Dependencies
- `oma image generate` CLI and vendor authentication
- Codex image generation, Pollinations API, or Gemini API/CLI strategy
- `resources/vendor-matrix.md`, `resources/prompt-tips.md`, and `config/image-config.yaml`

### Control-flow features
- Branches by prompt ambiguity, vendor auth, cost threshold, reference-image support, path safety, and safety/timeout exit codes
- Calls external vendor APIs/CLIs
- Reads reference images and writes generated images plus manifests

## Structural Flow

### Entry
1. Validate that the request contains enough subject, setting, style, usage, and aspect-ratio signal.
2. Detect attached/reference images and vendor support.
3. Check authentication, cost guardrails, output path, and count limits.

### Scenes
1. **PREPARE**: Clarify or amplify prompt and choose vendor strategy.
2. **ACQUIRE**: Validate auth, references, output path, and provider availability.
3. **ACT**: Invoke `oma image generate` with selected vendor(s), prompt, references, and options.
4. **VERIFY**: Check manifest, output files, exit code, and provider result.
5. **FINALIZE**: Return output paths and relevant warnings.

### Transitions
- If prompt lacks required signal, clarify or show amplified prompt before generation.
- If `--vendor all` is requested, require every requested vendor to be available.
- If reference path is supported by selected vendor, pass it automatically.
- If estimated cost exceeds guardrail, require confirmation unless bypassed.

### Failure and recovery
- If auth is missing, report vendor-specific authentication requirement.
- If reference support is unavailable for the selected vendor, reject with actionable guidance.
- If local CLI is outdated, ask user to run `oma update`.
- If generation times out or is blocked, surface exit code and provider status.

### Exit
- Success: images and manifest exist in the output directory.
- Partial success: some vendors fail in comparison mode and failures are reported.
- Failure: no image is produced and the route/cost/auth/safety blocker is explicit.

## Logical Operations

### Actions
| Action | SSL primitive | Evidence |
|--------|---------------|----------|
| Validate prompt completeness | `VALIDATE` | Clarification protocol |
| Select vendor strategy | `SELECT` | Vendor matrix and auth state |
| Read reference images | `READ` | `--reference` paths |
| Call generation CLI/API | `CALL_TOOL` | `oma image generate` |
| Write image outputs | `WRITE` | Image files and manifest |
| Validate result | `VALIDATE` | Exit code, manifest, files |
| Report output | `NOTIFY` | Final path summary |

### Tools and instruments
- `oma image generate`, `oma image doctor`, `oma image list-vendors`
- Codex, Pollinations, and Gemini provider paths
- Prompt tips, vendor matrix, and image config

### Canonical command path
```bash
oma image doctor
oma image generate "<prompt>" --vendor auto --size auto --quality auto --format json
```

With reference images:
```bash
oma image generate --reference "<absolute-path>" --vendor codex "<prompt>"
```

### Resource scope
| Scope | Resource target |
|-------|-----------------|
| `LOCAL_FS` | Reference images, generated images, manifests |
| `PROCESS` | Provider CLIs and image router commands |
| `NETWORK` | Pollinations/Gemini or provider APIs |
| `CREDENTIALS` | Provider auth and API keys |

### Preconditions
- Prompt is sufficiently specified or user approves amplification.
- Required vendor auth and output permissions exist.
- Reference paths are accessible when used.

### Effects and side effects
- Creates image files and manifests.
- May call paid or rate-limited provider APIs.
- May read attached/reference images.

### Guardrails

1. **Clarify before invoking** — if the user's request is ambiguous about subject, style, composition, or usage context, **ask the user first** or **amplify the prompt explicitly** (showing the user the expanded version for approval). Do NOT silently generate from a vague prompt. See `Clarification Protocol` below.
2. **Authentication-aware dispatch** — detect which vendor CLIs are authenticated and run only those; with `--vendor all`, every requested vendor must be available (strict).
3. **Cost guardrail** — confirm before executing runs whose estimated cost is ≥ `$0.20` (configurable). `--yes` / `OMA_IMAGE_YES=1` bypass. Default vendor `pollinations` (flux/zimage) is free, so auto-triggering on keywords is safe.
4. **Path safety** — output paths outside `$PWD` require `--allow-external-out`.
5. **Cancellable** — SIGINT/SIGTERM aborts in-flight provider calls and the orchestrator.
6. **Deterministic outputs** — every run writes `manifest.json` next to the images for reproducibility.
7. **Max `n` = 5** — wall-time bound.
8. **Exit codes align with `oma search fetch`** (0, 1, 2=safety, 3=not-found, 4=invalid-input, 5=auth-required, 6=timeout).

### Clarification Protocol

Before invoking `oma image generate`, the calling agent runs this checklist against the user's request. **If any answer is "no / unknown", clarify with the user first.**

**Required signal (must be present or inferable):**
- [ ] **Subject** — what is the primary thing in the image? (object, person, scene)
- [ ] **Setting / backdrop** — where is it? (context, environment)

**Strongly recommended (ask if absent AND not inferable from context):**
- [ ] **Style** — photorealistic, illustration, 3D render, oil painting, concept art, flat vector, …?
- [ ] **Mood / lighting** — bright vs moody, warm vs cool, dramatic vs minimal
- [ ] **Usage context** — hero image, icon, thumbnail, product shot, poster? (dictates aspect ratio + composition)
- [ ] **Aspect ratio** — square (`1024x1024`), portrait (`1024x1536`), landscape (`1536x1024`)?

**Amplification shortcut.** For brief prompts (e.g. "a red apple"), do not pop clarifying questions if the request is genuinely that simple — instead **amplify inline and show the user** the expanded version before invoking:

> User: "a red apple"
> Agent: "I'll generate this as: *a single glossy red apple centered on a clean white background, soft studio lighting, photorealistic, shallow depth of field, 1024×1024*. Shall I proceed, or would you like a different style/composition?"

Skip both clarification and amplification when the user has clearly authored a full creative brief (≥ 2 of: subject + style + lighting + composition). Respect their prompt verbatim.

**Category-specific briefs** (app mockup, poster, thumbnail, infographic, comic panel, avatar): consult `resources/prompt-tips.md` → *External Prompt Libraries*.

**Output language.** Generation prompts are sent to the provider in English (image models are trained predominantly on English captions). Translate the user's request if they wrote in another language, and show them the translated version during amplification so they can correct misreadings.

### Vendors

This skill follows oh-my-agent's CLI-first concept: whenever a vendor's native CLI can drive generation (and return raw bytes), the subprocess path is preferred over direct API keys. Direct API is only used as a fallback for vendors whose CLI can't yet emit raw image bytes.

| Vendor | Strategy | Models | Trigger |
|--------|----------|--------|---------|
| `codex` | CLI-first — `codex exec` via ChatGPT OAuth (`codex login`), built-in `image_gen` | `gpt-image-2` | Logged in via Codex CLI (no API key) |
| `pollinations` | Direct HTTP — `gen.pollinations.ai/v1/images/generations` (free signup for key) | Free: `flux`, `zimage`. Credit-gated: `qwen-image`, `wan-image`, `gpt-image-2`, `klein`, `kontext`, `gptimage`, `gptimage-large` | `POLLINATIONS_API_KEY` set (free at https://enter.pollinations.ai). No native CLI exists. |
| `gemini` | CLI-first fallback → direct API. `gemini -p` (stream) is the preferred path but currently disabled at precheck (CLI's agentic loop does not return raw `inlineData` bytes on stdout as of Gemini CLI 0.38). Until the CLI exposes a non-agentic image surface, the provider falls back to the direct `generativelanguage.googleapis.com` API. | `gemini-2.5-flash-image`, `gemini-3.1-flash-image-preview` | Preferred: `gemini auth login`. Fallback: `GEMINI_API_KEY` + billing. |

### Invocation

#### Standalone

```
/oma-image a red apple on white background
/oma-image --vendor all --size 1536x1024 jeju coastline at sunset
/oma-image -n 3 --quality high --out ./hero "minimalist dashboard hero illustration"
```

#### Shell CLI

```
oma image generate "<prompt>" [--vendor auto|codex|pollinations|gemini|all] [-n 1..5] \
                             [--size 1024x1024|1024x1536|1536x1024|auto] \
                             [--quality low|medium|high|auto] \
                             [--out <dir>] [--allow-external-out] \
                             [-r <path>]... \
                             [--timeout 180] [-y] [--no-prompt-in-manifest] \
                             [--dry-run] [--format text|json]
oma image doctor
oma image list-vendors
```

Gemini-only escalation flag: `--strategy mcp,stream,api` (overrides `vendors.gemini.strategies`).

#### Reference Images (`-r`, `--reference`)

Attach up to 10 reference images (PNG/JPEG/GIF/WebP, ≤ 5MB each) to guide style, subject identity, or composition. Repeatable or comma-separated.

```
oma image generate -r ~/Downloads/otter.jpeg "same otter in dramatic lighting"
oma image generate -r a.png -r b.png "blend these two styles"
```

Supported vendors:

| Vendor | Support | How |
|--------|---------|-----|
| `codex` (gpt-image-2) | ✅ | Passes `-i <path>` to `codex exec` |
| `gemini` (2.5-flash-image) | ✅ | Inlines base64 `inlineData` parts in request |
| `pollinations` | ❌ | Rejected with exit code 4 (requires URL hosting; see PR #2 roadmap) |

**Paths**: absolute or relative to `$CWD`. Host CLIs usually expose attached images via:
- **Claude Code**: `~/.claude/image-cache/<session>/N.png` (surfaced in system messages as `[Image: source: <path>]`)
- **Antigravity**: workspace upload directory (exact path shown in IDE)
- **Codex CLI as host**: user must pass the filesystem path explicitly; in-conversation attachments are not forwarded

#### Agent Behavior: Auto-forward Attached References (MANDATORY)

When ALL of the following are true, the calling agent MUST pass the attached image via `--reference <path>` automatically. Never describe the image in prose as a workaround.

1. The user asks to generate or edit an image (referencing the attached one by phrases like "이거", "this image", "same style as this", "이 수달", etc.).
2. A host-surfaced attached image is visible to the agent — e.g. a Claude Code system message with `[Image: source: <path>]`, or an Antigravity workspace upload path, or an explicit filesystem path in the user's message.
3. The selected vendor supports references (`codex` or `gemini`).

**Required action**: invoke `oma image generate --reference <absolute-path> --vendor <codex|gemini> "<prompt>"`. If the user didn't specify a vendor, default to `codex` (CLI-first, widest availability). Do NOT:

- Fall back to prose description ("I'll describe the otter's appearance...").
- Ask the user to re-type or re-attach the path.
- Claim the CLI doesn't support references without first running `oma image generate --help` to verify.

**If the local CLI is outdated** (`--reference` is missing from `--help`): tell the user to run `oma update` once, then retry. Do not silently degrade to prose.

**If the reference path is from Claude Code's `image-cache`**: note to the user that the path is session-scoped and suggest copying the file to a durable location if they want to reuse it later. Still proceed with the generation.

#### Shared Infrastructure (from other skills)

Other skills call `oma image generate --format json` and parse the JSON manifest from stdout.

### Output Layout

```
.agents/results/images/
├── 20260424-143052-ab12cd/                    # single-vendor run
│   └── pollinations-flux.jpg
│       (or codex-gpt-image-2.png)
│       manifest.json
└── 20260424-143122-7z9kqw-compare/            # --vendor all run
    ├── codex-gpt-image-2.png
    ├── pollinations-flux.jpg
    └── manifest.json
```

## References

Follow `resources/execution-protocol.md` step by step.
See `resources/vendor-matrix.md` for strategy precheck rules.
Use `resources/prompt-tips.md` for writing effective prompts.
Before submitting, run `resources/checklist.md`.

### Configuration

Project-specific settings: `config/image-config.yaml`.
Env vars: `OMA_IMAGE_DEFAULT_VENDOR`, `OMA_IMAGE_DEFAULT_OUT`, `OMA_IMAGE_YES`, `POLLINATIONS_API_KEY`, `GEMINI_API_KEY`, `OMA_IMAGE_GEMINI_STRATEGIES`.

- Execution steps: `resources/execution-protocol.md`
- Vendor matrix: `resources/vendor-matrix.md`
- Prompt tips: `resources/prompt-tips.md`
- Checklist: `resources/checklist.md`
- Context loading: `../_shared/core/context-loading.md`

© First Fluke · MIT · first-fluke/oh-my-agent

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

Все скиллы по теме «ИИ и ML» →

Сначала — oma-image от других авторов.

oma-image First Fluke Скилл oma-image генерирует изображения через несколько провайдеров сразу — Codex, Pollinations, Gemini — и подхватывает референсы для вариаций по стилю и композиции. CX Codex +1 ★ 1 472звёзд репо image-generation claude-office-skills Скилл image-generation для Claude Code составляет промпты для DALL-E, Midjourney и Stable Diffusion. Он подключается к задачам генерации изображения в заданном стиле или формате. CX Codex +1 5 800установок generate-image laurigates Скилл generate-image генерирует изображения из текстового описания через модель Gemini 3 Pro Image, работает на Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode. CX Codex +1 177установок baoyu-cover-image JimLiu Скилл baoyu-cover-image для Claude Code генерирует обложки статей по пяти параметрам. Запускается по запросу «сделай обложку для статьи» или «generate cover image». CX Codex +1 32 900установок eachlabs-image-generation eachlabs Скилл eachlabs-image-generation для Claude Code генерирует изображения по текстовому описанию через EachLabs Predictions API. Агент отслеживает статус и возвращает ссылку на готовый файл. CX Codex +1 351установок flux-image acedatacloud Скилл flux-image генерирует и редактирует изображения через API AceDataCloud: текст в картинку, правки по описанию, видео FLUX 3. Работает через OpenClaw Gateway с ключом ACEDATACLOUD_API_TOKEN в .env. CX Codex +1 238установок jimeng-api-image-gen wvlvik Скилл jimeng-api-image-gen для Claude Code, Codex, Cursor и других платформ генерирует изображения через Volcengine Jimeng API 4.0. Включается при запросах «создай картинку», «нарисуй» или упоминании Jimeng. CX Codex +1 503установок

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

Весь набор →
oma-slide Скилл oma-slide создаёт, импортирует и редактирует презентации, а затем собирает HTML-дек в PDF, PNG или PPTX. Запускается по запросу на слайды или работу с готовой презентацией. CX Codex +1 ★ 1 472звёзд репо oma-frontend Скилл oma-frontend для Claude Code помогает создавать и менять интерфейсы на React, Next.js или Angular. Разбирает компоненты, страницы, стили, формы и клиентское состояние. CX Codex +1 ★ 1 472звёзд репо oma-academic-writing Скилл oma-academic-writing для Claude Code и Codex пишет и вычитывает научные статьи, отчёты и обзоры литературы на английском языке. Проверяет структуру фраз, хеджирование и подтверждение тезисов фактами. CX Codex +1 ★ 1 472звёзд репо oma-refactor Скилл oma-refactor для Claude Code и Codex перестраивает структуру кода без изменений в его наблюдаемом поведении. Проводит точечный рефакторинг техдолга и горячих точек через мелкие проверенные шаги. CX Codex +1 ★ 1 472звёзд репо oma-scholar Скилл oma-scholar ищет научные публикации, разбирает claims и evidence, создаёт и проверяет sidecar-файлы .knows.yaml. Работает в Claude Code и Codex. CX Codex +1 ★ 1 472звёзд репо oversized-skill Скилл oversized-skill для Claude Code проверяет обработку тела, превышающего рекомендованные 500 строк. CX Codex +1 ★ 1 472звёзд репо oma-security Скилл oma-security запускает аудит безопасности исходного кода, пакетов скиллов и компонентов MCP. Включается при проверке репозитория перед релизом или настройке CI-гейтов. CX Codex +1 ★ 1 472звёзд репо oma-voice Скилл oma-voice генерирует речь, расшифровывает аудио и обрабатывает готовые файлы. Скилл включается для озвучки текста, транскрипции или подготовки аудио с заданными параметрами. CX Codex +1 ★ 1 472звёзд репо

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

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