Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
intellectronica avatar

Nano Banana Pro

  • 2.9k installs
  • 279 repo stars
  • Updated April 25, 2026
  • intellectronica/agent-skills

nano-banana-pro is an agent skill that generates and edits PNG images using Google's Gemini 3 Pro Image API via a uv-run Python script.

About

nano-banana-pro generates and edits images through Google's Nano Banana Pro API, implemented as Gemini 3 Pro Image, using a bundled Python script run with uv from the user's current working directory. Text-to-image mode passes a prompt and output filename; image-to-image editing adds --input-image without reading the source file into context first. Resolution flags accept 1K as default, 2K for medium output, and 4K for high resolution, mapping user phrases like 1080p or ultra to the correct API parameter. API keys resolve from --api-key or GEMINI_API_KEY environment variable with a hard error when missing. Filenames follow yyyy-mm-dd-hh-mm-ss-descriptive-name.png patterns with concise hyphenated descriptors. The skill instructs agents not to read generated images back and to report only the saved file path. Editing prompts cover add or remove elements, style changes, color adjustments, and background blur tasks on user-supplied image paths.

  • Runs generate_image.py via uv for text-to-image and image-to-image editing.
  • Supports 1K 2K and 4K resolution flags mapped from natural language requests.
  • Uses --input-image for edits without reading the source image into agent context.
  • Resolves GEMINI_API_KEY from flag or environment with explicit missing-key errors.
  • Saves timestamped PNG filenames in the user's current working directory.

Nano Banana Pro by the numbers

  • 2,859 all-time installs (skills.sh)
  • +58 installs in the week ending Jul 28, 2026 (Skillselion tracking)
  • Ranked #136 of 1,340 Generative Media skills by installs in the Skillselion catalog
  • Security screen: HIGH risk (skills.sh audit)
  • Data as of Jul 28, 2026 (Skillselion catalog sync)
At a glance

nano-banana-pro capabilities & compatibility

Capabilities
text to image generation via gemini 3 pro image · image to image editing with input image path · 1k 2k 4k resolution parameter mapping · timestamped png output filename generation
Works with
openai
Use cases
image generation
Pricing
Bring your own API key
From the docs

What nano-banana-pro says it does

DO NOT read the image file first - use this skill directly with the --input-image parameter.
SKILL.md
npx skills add https://github.com/intellectronica/agent-skills --skill nano-banana-pro

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs2.9k
repo stars279
Security audit1 / 3 scanners passed
Last updatedApril 25, 2026
Repositoryintellectronica/agent-skills

How do I generate or edit images with Gemini 3 Pro Image at 1K, 2K, or 4K without manually wiring the API?

Generate or edit PNG images via Google's Nano Banana Pro Gemini 3 Pro Image API with 1K, 2K, or 4K resolution options.

Who is it for?

Developers who want agent-driven text-to-image or image-to-image edits through Gemini with resolution control.

Skip if: Skip when you need video, 3D assets, or a non-Gemini image provider.

When should I use this skill?

User asks to generate, create, edit, modify, or change an image, including modify this image with a file path.

What you get

A PNG saved to the working directory with the script-printed full output path reported to the user.

  • PNG image file in working directory

By the numbers

  • Supports 3 resolution options: 1K, 2K, and 4K
  • Requires Python >=3.10 with google-genai>=1.0.0 and pillow>=10.0.0

Files

SKILL.mdMarkdownGitHub ↗

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:

uv run ~/.claude/skills/nano-banana-pro/scripts/generate_image.py --prompt "your image description" --filename "output-name.png" [--resolution 1K|2K|4K] [--api-key KEY]

Edit existing image:

uv run ~/.claude/skills/nano-banana-pro/scripts/generate_image.py --prompt "editing instructions" --filename "output-name.png" --input-image "path/to/input.png" [--resolution 1K|2K|4K] [--api-key KEY]

Important: Always run from the user's current working directory so images are saved where the user is working, not in the skill directory.

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. GEMINI_API_KEY environment variable

If neither is available, the script exits with an error message.

Filename Generation

Generate filenames with the pattern: yyyy-mm-dd-hh-mm-ss-name.png

Format: {timestamp}-{descriptive-name}.png

  • Timestamp: Current date/time in format yyyy-mm-dd-hh-mm-ss (24-hour format)
  • Name: Descriptive lowercase text with hyphens
  • Keep the descriptive part concise (1-5 words typically)
  • Use context from user's prompt or conversation
  • If unclear, use random identifier (e.g., x9k2, a7b3)

Examples:

  • Prompt "A serene Japanese garden" → 2025-11-23-14-23-05-japanese-garden.png
  • Prompt "sunset over mountains" → 2025-11-23-15-30-12-sunset-mountains.png
  • Prompt "create an image of a robot" → 2025-11-23-16-45-33-robot.png
  • Unclear context → 2025-11-23-17-12-48-x9k2.png

Image Editing

When the user wants to modify an existing image: 1. Check if they provide an image path or reference an image in the current directory 2. Use --input-image parameter with the path to the image 3. The prompt should contain editing instructions (e.g., "make the sky more dramatic", "remove the person", "change to cartoon style") 4. Common editing tasks: add/remove elements, change style, adjust colors, blur background, etc.

Prompt Handling

For generation: Pass user's image description as-is to --prompt. Only rework if clearly insufficient.

For editing: Pass editing instructions in --prompt (e.g., "add a rainbow in the sky", "make it look like a watercolor painting")

Preserve user's creative intent in both cases.

Output

  • Saves PNG to current directory (or specified path if filename includes directory)
  • Script outputs the full path to the generated image
  • Do not read the image back - just inform the user of the saved path

Examples

Generate new image:

uv run ~/.claude/skills/nano-banana-pro/scripts/generate_image.py --prompt "A serene Japanese garden with cherry blossoms" --filename "2025-11-23-14-23-05-japanese-garden.png" --resolution 4K

Edit existing image:

uv run ~/.claude/skills/nano-banana-pro/scripts/generate_image.py --prompt "make the sky more dramatic with storm clouds" --filename "2025-11-23-14-25-30-dramatic-sky.png" --input-image "original-photo.jpg" --resolution 2K

Related skills

Forks & variants (1)

Nano Banana Pro has 1 known copy in the catalog totaling 29 installs. They canonicalize to this original listing.

How it compares

Gemini image CLI wrapper, not a general multi-provider media studio.

FAQ

Should the agent read the image file before editing?

No. Use this skill directly with --input-image; do not read the image into context first.

How is the API key provided?

Pass --api-key or set GEMINI_API_KEY; the script errors if neither is available.

Is Nano Banana Pro safe to install?

skills.sh reports 1 of 3 security scanners passed. Review the Security Audits panel on this page before installing in production.

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.