oma-image

Generates images through multi-vendor AI routing across Codex, Antigravity, and Pollinations providers.

Updated Mar 26, 2026
One-click install
npx skills add https://github.com/javiruu/viru-air --skill oma-image-javiruu
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: oma-image
Source: https://github.com/javiruu/viru-air/tree/main/.agents/skills/oma-image
Command: npx skills add https://github.com/javiruu/viru-air --skill oma-image-javiruu

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Choosing and authenticating the right AI image generation vendor for each request is tedious, and vague prompts produce poor results. This Skill routes image generation requests to authenticated vendors (Codex gpt-image-2, Antigravity nano-banana, or Pollinations flux/zimage) with prompt clarification, cost guardrails, and reproducible output manifests. ## Core Features & Use Cases - Authentication-aware multi-vendor dispatch: Detects which vendor CLIs are authenticated and routes generation accordingly, with a strict --vendor all comparison mode that writes side-by-side outputs. - Prompt clarification and amplification: Validates that prompts contain subject, setting, style, and aspect-ratio signal, and amplifies brief prompts with user approval before generation. - Reference image support: Forwards up to 10 attached reference images to Codex or Antigravity for style and subject guidance, with magic-byte validation. - Cost guardrails and manifests: Confirms runs estimated at $0.20 or more and writes a manifest.json with prompt, vendor, model, and strategy attempts for reproducibility. - Use Case: A designer asks for a hero illustration in a specific style; the Skill amplifies the prompt, checks vendor health with oma image doctor, generates via the authenticated vendor, and returns the image path plus manifest. ## Quick Start Ask the agent to generate an image, for example: generate a minimalist dashboard hero illustration at 1536x1024 using the default vendor.

Frequently Asked Questions about oma-image

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate an AI image with multiple vendors at once?▼

Run oma image generate with --vendor all to produce the same prompt on every authenticated vendor. Outputs land in a timestamped compare folder with a single manifest.json, letting you pick the best result side by side.

Which image generation vendors does this skill support?▼

It supports Codex (gpt-image-2 via ChatGPT OAuth), Antigravity (nano-banana via the agy CLI and Gemini Code Assist), and Pollinations (flux and zimage with a free API key). Vendor availability is checked with oma image doctor.

Can I use reference images when generating AI images?▼

Yes, pass up to 10 reference images with --reference for Codex or Antigravity. Files must be PNG, JPEG, GIF, or WebP under 5MB each; Pollinations does not support references and returns exit code 4.

Why does image generation fail with exit code 5?▼

Exit code 5 means no required vendor is authenticated or installed. Run oma image doctor to see which vendors are healthy and follow the vendor-specific setup instructions, such as codex login or setting POLLINATIONS_API_KEY.

How do I avoid unexpected costs when generating images?▼

Runs estimated at $0.20 or more require confirmation unless you pass --yes or set OMA_IMAGE_YES=1. Use --dry-run to preview vendors, counts, and cost before executing, and note that Pollinations and Antigravity are free.

What are the limitations of this image generation skill?▼

It cannot edit existing images, generate video or audio, or compose SVG vector art. Generation is capped at 5 images per run, and output paths outside the working directory require --allow-external-out.