How do I install the Nano Banana Pro skill?

Run npx skillmds@latest add geegewu/nano-banana-pro in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Nano Banana Pro safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: executes scripts, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Nano Banana Pro?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Nano Banana Pro free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Nano Banana Pro?

geegewu (@geegewu) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Nano Banana Pro by geegewu — Agent Skill

Name: Nano Banana Pro
Rating: 4.666666666666667 (3 reviews)
Author: geegewu

File contents

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

Generate new image:

uv run ${CLAUDE_SKILL_DIR}/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_SKILL_DIR}/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.

Default Workflow (draft → iterate → final)

Draft (1K): quick feedback loop
Iterate: adjust prompt in small diffs; keep filename new per run
Final (4K): only when prompt is locked

Resolution Options

1K (default) - ~1024px resolution
2K - ~2048px resolution
4K - ~4096px resolution

Map user requests:

No mention → 1K
"low resolution", "1080p", "1K" → 1K
"2K", "2048", "medium resolution" → 2K
"high resolution", "hi-res", "4K", "ultra" → 4K

API Key

Check order:

--api-key argument
GEMINI_API_KEY_1 to GEMINI_API_KEY_6 (rotation)
GEMINI_API_KEY fallback

Proxy

Supports proxy via GEMINI_PROXY, HTTPS_PROXY, or HTTP_PROXY environment variables.

Filename Generation

Pattern: yyyy-mm-dd-hh-mm-ss-descriptive-name.png

Examples:

"A serene Japanese garden" → 2025-11-23-14-23-05-japanese-garden.png
Unclear context → 2025-11-23-17-12-48-x9k2.png

Image Editing

Use --input-image with editing instructions in --prompt. Resolution auto-detected from input image when not explicitly set.

Prompt Templates (high hit-rate)

Generation: "Create an image of: . Style: . Composition: <camera/shot>. Lighting: . Background: . Color palette: . Avoid: ."
Editing: "Change ONLY: . Keep identical: subject, composition/crop, pose, lighting, color palette, background, text, and overall style."

Output

Saves PNG to current directory
Script outputs the full path to the generated image
Do not read the image back — just inform the user of the saved path

---name: nano-banana-prodescription: Generate/edit images with Nano Banana Pro (Gemini 3 Pro Image). Use for image create/modify requests. Supports text-to-image + image-to-image; 1K/2K/4K. 用户说"生成图片"、"生图"、"编辑图片"时触发。---# Nano Banana Pro Image Generation & EditingGenerate new images or edit existing ones using Google's Nano Banana Pro API (Gemini 3 Pro Image).## Usage**Generate new image:**```bashuv run ${CLAUDE_SKILL_DIR}/scripts/generate_image.py --prompt "your image description" --filename "output-name.png" [--resolution 1K|2K|4K] [--api-key KEY]```**Edit existing image:**```bashuv run ${CLAUDE_SKILL_DIR}/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.## Default Workflow (draft → iterate → final)- Draft (1K): quick feedback loop- Iterate: adjust prompt in small diffs; keep filename new per run- Final (4K): only when prompt is locked## Resolution Options- **1K** (default) - ~1024px resolution- **2K** - ~2048px resolution- **4K** - ~4096px resolutionMap user requests:- No mention → `1K`- "low resolution", "1080p", "1K" → `1K`- "2K", "2048", "medium resolution" → `2K`- "high resolution", "hi-res", "4K", "ultra" → `4K`## API KeyCheck order:1. `--api-key` argument2. `GEMINI_API_KEY_1` to `GEMINI_API_KEY_6` (rotation)3. `GEMINI_API_KEY` fallback## ProxySupports proxy via `GEMINI_PROXY`, `HTTPS_PROXY`, or `HTTP_PROXY` environment variables.## Filename GenerationPattern: `yyyy-mm-dd-hh-mm-ss-descriptive-name.png`Examples:- "A serene Japanese garden" → `2025-11-23-14-23-05-japanese-garden.png`- Unclear context → `2025-11-23-17-12-48-x9k2.png`## Image EditingUse `--input-image` with editing instructions in `--prompt`.Resolution auto-detected from input image when not explicitly set.## Prompt Templates (high hit-rate)- Generation: "Create an image of: <subject>. Style: <style>. Composition: <camera/shot>. Lighting: <lighting>. Background: <background>. Color palette: <palette>. Avoid: <list>."- Editing: "Change ONLY: <single change>. Keep identical: subject, composition/crop, pose, lighting, color palette, background, text, and overall style."## Output- Saves PNG to current directory- Script outputs the full path to the generated image- Do not read the image back — just inform the user of the saved path

Frequently asked questions

Nano Banana Pro