nano-banana-pro-openrouter

Nano Banana Pro OpenRouter Adapter

This skill is a deterministic adapter around OpenRouter image generation. It is intended for meta-skill skill_exec use, not as an open-ended agent surface.

Contract

• During MetaSkill execution, accepts only the parent-resolved, process-local provider lease. The credential, endpoint, and proxy never enter with, argv, the plan, or persisted run data. Direct standalone CLI use may still provide OPENROUTER_API_KEY.
• Does not read .env files, prompt for credentials, print credentials, or write credentials to disk.
• Uses only the model, base URL, output directory, and local path prefix passed by the caller.
• Saves generated image bytes under the supplied output directory.
• Emits one IMAGE_READY: JSON line per saved image.
• A missing/invalid required MetaSkill lease exits 78 before any provider submission. Provider failures after submission emit IMAGE_GENERATION_FAILED with exit 0 so the webpage can bind a replacement slot without auto-replay.

Meta-Skill Payload Mode

When stdin is JSON containing media_slots, image_slots, slots, or page_outline, the adapter generates image slots and preserves already downloaded images. Structured slots are preferred over free-form outline text:

{
  "requirement_framing": "...",
  "media_slots": {"slots": [{"slot_id": "hero-visual", "modality": "image"}]},
  "page_outline": "...",
  "image_download": "...",
  "include_images": "YES",
  "visual_style": "..."
}

Existing IMAGE_READY: records in image_download are preserved. If IMAGE_DOWNLOAD_INCOMPLETE: lists unfilled_slot_ids, only those slots are generated. If the caller requested images but both structured slots and outline slot parsing are empty, the adapter synthesizes minimal webpage-safe image slots from the brief instead of emitting no_image_slots_to_generate.

Plain Prompt Mode

When stdin is plain text, the adapter generates one image using that text as the prompt and the --filename stem as the slot_id.