oma-image
Generate raster images or reference-guided variations through the OMA image CLI. Use for image assets or explicit vendor comparisons; pixel editing uses an editor.
How do I install this agent skill?
npx skills add https://github.com/first-fluke/oh-my-agent --skill oma-imageIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill provides an interface for generating images using multiple vendors like Codex, Antigravity, and Pollinations. It uses a CLI-first approach, executing shell commands to interact with vendor tools. The skill includes robust guardrails for cost control, path safety, and input validation. It also references external prompt galleries on GitHub to improve generation quality.
- Socketpass
No alerts
- Snykfail
Risk: CRITICAL · 3 issues
What does this agent skill do?
Image Agent - Multi-Vendor Image Router
Scheduling
Goal
Generate images and visual assets through authenticated multi-vendor routing while preserving prompt clarity, reference-guided regeneration, 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 for a new generated variation 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, Antigravity)
- Other skills needing image generation infrastructure (shared invocation)
- Regenerating a new image that follows a supplied reference's subject, style, lighting, or composition
When NOT to use
- Pixel-level editing, masking, inpainting, object removal, compositing, cropping, resizing, or format conversion -> out of scope; use an image editor or a tool that explicitly supports that operation.
- 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, Antigravity (
agy), or Pollinations
Expected outputs
- Generated image files under
.agents/results/images/or requested output directory manifest.jsonwith prompt, vendor, model, and reproducibility metadata- Vendor comparison outputs when
--vendor allis used
Dependencies
oma image generateCLI and vendor authenticationoma image doctorandoma image vendor listfor vendor availability and supported models- Codex image generation, Antigravity (
agy), or the Pollinations API resources/vendor-matrix.md,resources/prompt-tips.md, and theimage:section of.agents/oma-config.yaml
Structural Flow
Transitions
- If the subject or intended result cannot be inferred, clarify that missing input; otherwise proceed with reasonable defaults.
- If
--vendor allis requested, require every requested vendor to be available. - If the request is reference-guided regeneration and the selected vendor supports references, pass it automatically.
- When the vendor is chosen by the agent (not fixed by an explicit
--vendor), record it with subjectimage.route-selectionperreferences/_shared/runtime/route-selection.md: vendor/model, and the auth, reference-support, or cost fact that decided it. - If the request requires pixel, mask, crop, resize, or format editing, stop before generation and name the unsupported operation and an appropriate editor route.
- 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
Canonical command path
- Check that the request carries enough subject, setting, style, usage, and aspect-ratio signal; resolve gaps per Creative brief.
- Classify a supplied image as a reference for a newly generated variation, or as a request for unsupported pixel/mask editing (stop per Transitions). Confirm reference paths are accessible.
- Check vendor authentication, then the cost guardrail, output path and its permissions, and count limit (Guardrails 2-4 and 7):
oma image doctor - Generate:
With reference images:oma image generate "<prompt>" --vendor auto --size auto --quality auto --output jsonoma image generate --reference "<absolute-path>" --vendor codex "<prompt>" - Confirm the images and
manifest.jsonexist in the output directory, runresources/checklist.md, and report the output paths; on failure, report the exit code and provider status.
Resource scope and effects
Reads attached or reference images. Creates image files and manifest.json under .agents/results/images/ or the requested output directory. Runs the image router and provider CLIs (Codex, agy), which call their own backends, and calls the Pollinations API. Uses provider auth and API keys. Provider APIs may be paid or rate-limited.
Guardrails
- Resolve the brief: use supplied details and reasonable creative defaults. Ask only when a missing choice materially changes the requested result. Do not require approval of an expanded prompt when generation is already authorized.
- Authentication-aware dispatch: detect which vendor CLIs are available and run only those; with
--vendor all, every requested vendor must be available (strict). Caveat: theantigravityhealth check verifies installation only (agy --version) — a signed-out agy passes health and fails at generate time with agy's own error. - Cost guardrail: confirm before executing runs whose estimated cost is ≥
$0.20(configurable).--yes/OMA_IMAGE_YES=1bypass. Choose generation from the requested outcome, not keyword presence. Non-interactive contexts (agents, CI — no TTY on stdin): the CLI cannot prompt, so a run at/over the threshold exits 1 with a message naming--yes. Use--dry-runto estimate cost. Reuse an existing budget authorization; otherwise confirm the additional spend before re-running with-y. - Path safety: output paths outside
$PWDrequire--allow-external-output. - Cancellable: SIGINT/SIGTERM aborts in-flight provider calls and the orchestrator.
- Deterministic outputs: every run writes
manifest.jsonnext to the images for reproducibility. - Max
n= 5: wall-time bound. - Exit codes align with
oma search fetch(0, 1, 2=safety, 3=not-found, 4=invalid-input, 5=auth-required, 6=timeout).
Creative brief
Use the requested subject and constraints. Infer setting, style, lighting, and aspect ratio when unspecified; preserve explicit text and reference intent. Ask only for a material unresolved choice. Read resources/prompt-tips.md for an unfamiliar image category.
References
- Provider invocation, references, and output layout:
resources/invocation.md(selected vendor or reference-image operation only).
Configuration
Project-specific settings: the image: section of .agents/oma-config.yaml, which oma update preserves. Shipped defaults live in the CLI (DEFAULTS in cli/commands/image/config.ts) — write only the keys you change.
Env vars: OMA_IMAGE_DEFAULT_VENDOR, OMA_IMAGE_DEFAULT_OUT, OMA_IMAGE_YES, POLLINATIONS_API_KEY.
- Execution steps (follow for the selected task):
resources/execution-protocol.md - Vendor matrix:
resources/vendor-matrix.md - Prompt tips:
resources/prompt-tips.md - Checklist (run before handoff):
resources/checklist.md - Context loading:
references/_shared/core/context-loading.md
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/first-fluke/oh-my-agent/oma-image">View oma-image on skillZs</a>