Agent skill · design visual · sundial-org
nano-banana-pro
Generate/edit images with Nano Banana Pro (Gemini 3 Pro Image). Use for image create/modify requests incl. edits. Supports text-to-image + image-to-image; 1K/2K/4K; use --input-image.
Why this skill is useful
Adds executable scripts for image generation and editing using the Nano Banana Pro API, which are not publicly documented.
What it needs
Requires uv installed locally. Requires gemini account access. About 3k tokens when loaded. Last updated 2026-03-07. 639 stars on the source repository.
What this skill does
Nano Banana Pro Image Generation & Editing Generate new images or edit existing ones using Google's Nano Banana Pro API (Gemini 3 Pro Image). Usage Run the script using absolute path (do NOT cd to skill directory first): Generate new image: Edit existing image: Important: Always run from the user's current working directory so images are saved where the user is working, not in the skill directory. Default Workflow (draft → iterate → final) Goal: fast iteration without burning time on 4K until the prompt is correct. Draft (1K): quick feedback loop uv run ~/.codex/skills/nano-banana-pro/scripts/generateimage.py --prompt "<draft prompt>" --filename "yyyy-mm-dd-hh-mm-ss-draft.png" --resolution 1K Iterate: adjust prompt in small diffs; keep filename new per run If editing: keep the same --input-image for every iteration until you’re happy. Final (4K): only when prompt is locked uv run ~/.codex/skills/nano-banana-pro/scripts/generateimage.py --prompt "<final prompt>" --filename "yyyy-mm-dd-hh-mm-ss-final.png" --resolution 4K Resolution Options The Gemini 3 Pro Image API supports three resolutions (uppercase K required): 1K (default) - ~1024px resolution 2K - ~2048px resolution 4K - ~4096px resolution Map user requests to API parameters: No mention of resolution → 1K "low resolution", "1080", "1080p", "1K" → 1K "2K", "2048", "normal", "medium resolution" → 2K "high resolution", "high-res", "hi-res", "4K", "ultra" → 4K API Key The script checks for API key in this order: 1. --api-key argument (use if user provided key in chat) 2. GEMINIAPIKEY environment variable If neither is available, the script exits with an error message. Preflight + Common Failures (fast fixes) Preflight: command -v uv (must exist) test -n \"$GEMINIAPIKEY\" (or pass --api-key) If editing: test -f \"path/to/input.png\" Common failures: Error: No API key provided. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills sundial-org/nano-banana-pro