event4u-app/agent-config/src/skills/image-provider-routing/SKILL.md
Select the right image-generation provider from job shape — text-in-image to Ideogram, photoreal to Flux, vector/logo to Recraft, general to Gemini/GPT.
Decision brief
Route an image generation job to the right provider based on job shape. Adapters are scaffold-tier (dry-run only) — selection produces a plan; execution waits on promotion per provider-lifecycle-discipline.
Compatibility matrix
| Platform | Status | Evidence | What to check |
|---|---|---|---|
| Codex | Not declared | No explicit evidence | Portability before use |
| Claude Code | Not declared | No explicit evidence | Portability before use |
| Cursor | Not declared | No explicit evidence | Portability before use |
| Gemini CLI | Not declared | No explicit evidence | Portability before use |
Installation
The source command is displayed only when detected. A safe inspection prompt is always available so your agent can explain every action before execution.
npx skills add https://github.com/event4u-app/agent-config --skill "src/skills/image-provider-routing"Inspect the Agent Skill "image-provider-routing" from https://github.com/event4u-app/agent-config/blob/798a65522c7a73b90526641d6d1589fe0937cb5f/src/skills/image-provider-routing/SKILL.md at commit 798a65522c7a73b90526641d6d1589fe0937cb5f. List every install step, command, network request, credential, file read/write, external action, and rollback step. Explain whether it fits my task. Do not install or execute anything until I approve.
Workflow
1. Extract job shape from the brief: does it need embedded text? vector output? photorealistic rendering? or general illustration? 2. Apply table — match the dominant shape to the provider row above. 3. Check lifecycle tier — all adapters are experimental (scaffold). Surface thi…
Choosing which image model fits a brief (logo, banner, photo, icon, general art).
Decision order: text-in-image → Ideogram; must-be-vector → Recraft; photoreal → Flux; everything else → Gemini-image (default) or GPT Image 2 (when OpenAI key available and editing an existing image).
1. Chosen provider — name + one-line rationale citing the job-shape match. 2. Lifecycle-tier caveat — "adapter is experimental (scaffold tier); dry-run only until a smoke trace is captured per provider-lifecycle-discipline." 3. Fallback — if the primary adapter is unavailable or…
Good example: "Text logo for a bakery → Ideogram (text-in-image); lifecycle: experimental — dry-run plan only."
Permission review
No configured static risk pattern was detected
This is not proof of safety. Runtime behavior, indirect dependencies, and hidden external systems are outside the static scan.
Evidence record
| Signal | Value | Evidence type | Meaning |
|---|---|---|---|
| Quality score | 91/100 | Computed | Documentation, specificity, maintenance, and trust rules |
| Repository stars | 7 | Source | Repository attention, not individual Skill quality |
| Compatibility | 0 platforms | Source | Declared in the catalog source record |
| Usage guide | automated source guide | Editorial | Generated or reviewed according to the visible evidence level |
Pinned source
Route an image generation job to the right provider based on job shape. Adapters
are scaffold-tier (dry-run only) — selection produces a plan; execution waits on
promotion per provider-lifecycle-discipline.
node_modules/@event4u/agent-config/src/scripts/ai-image/adapters/*.sh adapter.| Job shape | Provider | Why |
|---|---|---|
| Text-in-image (logo, banner, typographic art) | Ideogram | Best glyph rendering; raster models garble text |
| Photoreal (product shot, portrait, scene) | Flux | Photorealism specialist; routed via fal/Replicate |
| Vector / SVG logo or icon | Recraft | Produces genuine <path> SVG; raster cannot |
| General art / edit / multimodal | Gemini-image or GPT Image 2 | Broad capability; natural-language prompts |
| Budget-conscious 4K upscale | Flux via Replicate | Cost-competitive at high resolution |
Decision order: text-in-image → Ideogram; must-be-vector → Recraft; photoreal → Flux; everything else → Gemini-image (default) or GPT Image 2 (when OpenAI key available and editing an existing image).
experimental (scaffold). Surface
this before any live invocation.provider-lifecycle-discipline."<path> SVG a brand mark needs (→ Recraft).ideogram.sh, flux.sh, recraft.sh, gemini-image.sh) are
scaffold-tier — dry-run plumbing only, no live generation yet. Routing
produces a selection + plan; actual API calls require promotion to stable
first (maintainer-captured smoke trace under agents/reference/ai-image/smoke-traces/).
Surfacing a provider without its experimental tier caveat misleads the caller
into expecting a rendered asset that won't come.Good example: "Text logo for a bakery → Ideogram (text-in-image); lifecycle: experimental — dry-run plan only."
Bad example: "Use Recraft for the product photo" — Recraft is the vector path; photoreal jobs go to Flux.
experimental).<path> SVG.image-likeness-and-rights when the brief names a real person or brand mark.experimental to stable — that is maintainer-only via smoke trace.prompt-engineering-image — translate the brief into provider-specific prompt grammar.provider-lifecycle-discipline — read lifecycle tier before any run.node_modules/@event4u/agent-config/src/scripts/ai-image/adapters/ — the four adapter files and their header comments.media-governance-routing — rights / likeness policies before generation.