Agent skill

Nano Banana Pro

by swarmclawai in swarmclawai/swarmclaw

Generate or edit images via Gemini 3 Pro Image (Nano Banana Pro).

MITAuto-check passedMedia & Creative

Install Nano Banana Pro

skills CLI
$ npx skills add swarmclawai/swarmclaw --skill nano-banana-pro -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install swarmclawai/swarmclaw nano-banana-pro --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/swarmclawai/swarmclaw.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/nano-banana-pro .claude/skills/nano-banana-pro && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
nano-banana-pro
GitHub stars
689
Token cost
~481 tokens
SKILL.md length
88 words
Files
2 (incl. scripts)
Skills in repo
12
Repo updated
First seen
Licence
MIT

At a glance

Generate or edit images via Gemini 3 Pro Image (Nano Banana Pro).

  • Asked to create
  • SKILL.md covers Generate, Edit (Single Image), Multi-Image Composition (up to… and API Key, plus 2 more sections
  • Runs Python scripts from its folder; calls uv; needs GEMINI_API_KEY
  • Edit images and a Gemini API key is available

What it does

Nano Banana Pro is an agent skill from swarmclawai/swarmclaw. Generate or edit images via Gemini 3 Pro Image (Nano Banana Pro). Use when asked to create, generate, or edit images and a Gemini API key is available. Supports text-to-image generation, single-image editing, and multi-image composition (up to 14 images).

Its SKILL.md is about 480 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including scripts (for example `scripts/generate_image.py`).

It sits in Media & Creative, covering Image generation, Image editing and LLM API integration. It works with Google Gemini and Model Context Protocol. The repository describes itself as: Open-source self-hosted AI agent runtime and multi-agent framework for autonomous agent swarms. Agent memory, MCP tools, schedules, delegation, and 23+ LLM providers (Claude… The licence is MIT.

When your agent uses it

  • Asked to create
  • Edit images and a Gemini API key is available

Example prompts

  • “/nano-banana-pro”

Requirements

  • Python 3
  • A credential in GEMINI_API_KEY

What it can do on your machine

Read from SKILL.md and the folder at commit ed38ba5. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • uv

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use uv, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • GEMINI_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Nano Banana Pro loads about 481 tokens when it runs. Until then it costs about 68 tokens; SKILL.md has 88 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~68
When it runs · the whole SKILL.md, loaded when a task matches
~481

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from swarmclawai/swarmclaw at commit ed38ba5, republished under its MIT licence (© swarmclawai). 88 words, ~481 tokens.

Download SKILL.mdSave it as .claude/skills/nano-banana-pro/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
nano-banana-pro
description
Generate or edit images via Gemini 3 Pro Image (Nano Banana Pro). Use when asked to create, generate, or edit images and a Gemini API key is available. Supports text-to-image generation, single-image editing, and multi-image composition (up to 14 images).

Nano Banana Pro (Gemini 3 Pro Image)

Use the bundled script to generate or edit images.

Generate

bash
uv run {baseDir}/scripts/generate_image.py --prompt "your image description" --filename "output.png" --resolution 1K

Edit (Single Image)

bash
uv run {baseDir}/scripts/generate_image.py --prompt "edit instructions" --filename "output.png" -i "/path/in.png" --resolution 2K

Multi-Image Composition (up to 14 images)

bash
uv run {baseDir}/scripts/generate_image.py --prompt "combine these into one scene" --filename "output.png" -i img1.png -i img2.png -i img3.png

API Key

Set GEMINI_API_KEY as an environment variable, or pass --api-key <KEY> to the script.

Aspect Ratio (optional)

bash
uv run {baseDir}/scripts/generate_image.py --prompt "portrait photo" --filename "output.png" --aspect-ratio 9:16

Notes

  • Resolutions: 1K (default), 2K, 4K.
  • Aspect ratios: 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9. Without --aspect-ratio, the model picks freely.
  • Use timestamps in filenames for uniqueness: yyyy-mm-dd-hh-mm-ss-name.png.
  • Do not read the image back into context; report the saved path only.

© swarmclawai, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (scripts) in skills/nano-banana-pro of swarmclawai/swarmclaw.

  • SKILL.md
  • scripts/generate_image.py

Open the folder on GitHubat commit ed38ba5

Compare with similar skills

Nano Banana Pro next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Nano Banana Pro compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Nano Banana Pro this skillswarmclawai/swarmclaw689—~481Automated safety check: PassMIT
Nanobanana Image GenerationLeoYeAI/openclaw-master-skills2.2k—~4.5kAutomated safety check: PassMIT
Nano Banananexu-io/nexu3.3k—~757Automated safety check: PassMIT
Image Generationshinpr/mcp-image172—~1.5kAutomated safety check: PassMIT
Gemini Interactions APIAyuilos/Miffan225—~4.6kAutomated safety check: PassAGPL-3.0
Imageguaardvark/guaardvark258—~1.8kAutomated safety check: PassMIT

Similar skills

  • Nanobanana Image Generation

    LeoYeAI/openclaw-master-skills

    A skill your agent uses when the user wants to generate or edit images with Google's Nanobanana/Gemini image models using the official Gemini API shape, or when they need publication-style…

    2.2k GitHub stars~4.5k tokensUpdated 2 mo ago
    Media & CreativeAuto-check passed
  • Nano Banana

    nexu-io/nexu

    Generate or edit images via Nano Banana image models. An agent skill from nexu-io/nexu.

    3.3k GitHub stars~757 tokensUpdated 5 mo ago
    Media & CreativeAuto-check passed
  • Image Generation

    shinpr/mcp-image

    Optimizes image generation prompts using Subject-Context-Style structure.

    172 GitHub stars~1.5k tokensUpdated 3 days ago
    Media & CreativeAuto-check passed
  • A skill your agent uses when writing code that calls the Gemini API for text generation, multi-turn chat, multimodal understanding, image generation, video generation, streaming responses…

    225 GitHub stars~4.6k tokensUpdated today
    Media & CreativeAuto-check passed
  • Image

    guaardvark/guaardvark

    Generate or edit images on the user's own GPU through Guaardvark: single images, instruction edits, background cut-outs, inpaint and outpaint, consistent characters from the Cast Library, and batch…

    258 GitHub stars~1.8k tokensUpdated today
    Media & CreativeAuto-check passed
  • Atlas Cloud

    calesthio/OpenMontage

    Generate or edit images and videos through the Atlas Cloud gateway.

    66k GitHub stars~1.2k tokensUpdated 7 days ago
    Media & CreativeAuto-check passed

More from swarmclawai/swarmclaw

All 12 skills in this repo
  • Openai Image Gen

    swarmclawai/swarmclaw

    Generate images via OpenAI Images API (GPT Image, DALL-E 3, DALL-E 2).

    689 GitHub stars~705 tokensUpdated 3 mo ago
    Auto-check passed
  • Skill Creator

    swarmclawai/swarmclaw

    Create, edit, improve, or audit skills for SwarmClaw agents.

    689 GitHub stars~1.4k tokensUpdated 3 mo ago
    Auto-check passed
  • Coding Agent

    swarmclawai/swarmclaw

    Delegate coding tasks to external coding agents (Claude Code, Codex, Pi, OpenCode) via shell.

    689 GitHub stars~900 tokensUpdated 3 mo ago
    Auto-check passed
  • GitHub

    swarmclawai/swarmclaw

    GitHub operations via gh CLI: issues, PRs, CI runs, code review, API queries.

    689 GitHub stars~820 tokensUpdated 3 mo ago
    Auto-check passed
  • Swarmclaw

    swarmclawai/swarmclaw

    AI agent runtime and multi-agent orchestration platform. An agent skill from swarmclawai/swarmclaw.

    689 GitHub stars~2k tokensUpdated 3 mo ago
    Auto-check passed
  • Swarmclaw

    swarmclawai/swarmclaw

    Manage your SwarmClaw agent fleet — agents, tasks, chats, chatrooms, goals, schedules, memory, wallets, connectors, autonomy, and 40+ more command groups.

    689 GitHub stars~4.2k tokensUpdated 3 mo ago
    Auto-check passed

Questions about Nano Banana Pro

What does Nano Banana Pro do?

Generate or edit images via Gemini 3 Pro Image (Nano Banana Pro). Nano Banana Pro is an agent skill from swarmclawai/swarmclaw. Generate or edit images via Gemini 3 Pro Image (Nano Banana Pro).

When should I use Nano Banana Pro?

Nano Banana Pro fits situations like: asked to create; edit images and a Gemini API key is available.

How do I install Nano Banana Pro in Claude Code?

Run `npx skills add swarmclawai/swarmclaw --skill nano-banana-pro -a claude-code`. Or copy the skill folder (skills/nano-banana-pro in swarmclawai/swarmclaw) into .claude/skills/nano-banana-pro in your project. Claude Code loads it when a task matches its description.

How do I install Nano Banana Pro in Codex?

Run `npx skills add swarmclawai/swarmclaw --skill nano-banana-pro -a codex`. Or copy the skill folder (skills/nano-banana-pro in swarmclawai/swarmclaw) into .agents/skills/nano-banana-pro in your project. Codex loads it when a task matches its description.

Can I use Nano Banana Pro in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add swarmclawai/swarmclaw --skill nano-banana-pro -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/nano-banana-pro, .gemini/skills/nano-banana-pro, .github/skills/nano-banana-pro and .opencode/skills/nano-banana-pro in your project.

What does Nano Banana Pro need to run?

Going by SKILL.md and its folder, Nano Banana Pro needs Python for the scripts in its folder, the command-line tools its instructions call (uv) and credentials named GEMINI_API_KEY. Our summary lists: Python 3; A credential in GEMINI_API_KEY.

Does Nano Banana Pro access the network?

SKILL.md contains no URLs. Its commands use uv, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Nano Banana Pro safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Nano Banana Pro use?

Nano Banana Pro is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Nano Banana Pro use?

About 481 tokens (SKILL.md is roughly 1.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Nano Banana Pro?

Skills that share tags, products or a category with Nano Banana Pro: Nanobanana Image Generation (LeoYeAI/openclaw-master-skills, 2.2k stars), Nano Banana (nexu-io/nexu, 3.3k stars), Image Generation (shinpr/mcp-image, 172 stars) and Gemini Interactions API (Ayuilos/Miffan, 225 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Nano Banana Pro?

swarmclawai (a GitHub organization) maintains it in swarmclawai/swarmclaw, which has 689 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on June 30, 2026.

Source: swarmclawai/swarmclaw on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.