Agent skill

Nano Banana

by mikeOnBreeze in mikeOnBreeze/cc-crossbeam

This skill enables image generation and editing using Google's Gemini Nano Banana models.

Install Nano Banana

skills CLI

$ npx skills add mikeOnBreeze/cc-crossbeam --skill nano-banana -a claude-code

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

GitHub CLI

$ gh skill install mikeOnBreeze/cc-crossbeam nano-banana --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/mikeOnBreeze/cc-crossbeam.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/nano-banana .claude/skills/nano-banana && 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/

Paste into Claude Code

Install the "nano-banana" agent skill from https://github.com/mikeOnBreeze/cc-crossbeam/tree/main/.claude/skills/nano-banana into .claude/skills/nano-banana/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "nano-banana", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/mikeOnBreeze/cc-crossbeam/tree/main/.claude/skills/nano-banana

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add mikeOnBreeze/cc-crossbeam --skill nano-banana -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install mikeOnBreeze/cc-crossbeam nano-banana --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/mikeOnBreeze/cc-crossbeam.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.claude/skills/nano-banana .agents/skills/nano-banana && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "nano-banana" agent skill from https://github.com/mikeOnBreeze/cc-crossbeam/tree/main/.claude/skills/nano-banana into .agents/skills/nano-banana/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "nano-banana", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add mikeOnBreeze/cc-crossbeam --skill nano-banana -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install mikeOnBreeze/cc-crossbeam nano-banana --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/mikeOnBreeze/cc-crossbeam.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.claude/skills/nano-banana .cursor/skills/nano-banana && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "nano-banana" agent skill from https://github.com/mikeOnBreeze/cc-crossbeam/tree/main/.claude/skills/nano-banana into .cursor/skills/nano-banana/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "nano-banana", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/mikeOnBreeze/cc-crossbeam.git --path .claude/skills/nano-banana

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add mikeOnBreeze/cc-crossbeam --skill nano-banana -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install mikeOnBreeze/cc-crossbeam nano-banana --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/mikeOnBreeze/cc-crossbeam.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.claude/skills/nano-banana .gemini/skills/nano-banana && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "nano-banana" agent skill from https://github.com/mikeOnBreeze/cc-crossbeam/tree/main/.claude/skills/nano-banana into .gemini/skills/nano-banana/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "nano-banana", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install mikeOnBreeze/cc-crossbeam nano-banana

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add mikeOnBreeze/cc-crossbeam --skill nano-banana -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/mikeOnBreeze/cc-crossbeam.git skills-src && mkdir -p .github/skills && cp -r skills-src/.claude/skills/nano-banana .github/skills/nano-banana && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "nano-banana" agent skill from https://github.com/mikeOnBreeze/cc-crossbeam/tree/main/.claude/skills/nano-banana into .github/skills/nano-banana/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "nano-banana", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add mikeOnBreeze/cc-crossbeam --skill nano-banana -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install mikeOnBreeze/cc-crossbeam nano-banana --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/mikeOnBreeze/cc-crossbeam.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.claude/skills/nano-banana .opencode/skills/nano-banana && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "nano-banana" agent skill from https://github.com/mikeOnBreeze/cc-crossbeam/tree/main/.claude/skills/nano-banana into .opencode/skills/nano-banana/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "nano-banana", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: nano-banana
GitHub stars: 293
Token cost: ~944 tokens
SKILL.md length: 268 words
Files: 5 (incl. scripts, references)
Skills in repo: 20
Repo updated: Mar 2, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

This skill enables image generation and editing using Google's Gemini Nano Banana models.

Works in 2 steps: Text-to-Image Generation → Image Editing
The user asks to generate images from text prompts
SKILL.md covers Prerequisites, Capabilities, Supported Parameters and Usage Examples, plus 2 more sections
Runs Python scripts from its folder; calls python and pip; needs GEMINI_API_KEY

What it does

Nano Banana is an agent skill from mikeOnBreeze/cc-crossbeam. This skill enables image generation and editing using Google's Gemini Nano Banana models. Use this skill when the user asks to generate images from text prompts, edit existing images, or modify pictures. Supports text-to-image generation, image editing with prompts, and multi-image reference for consistency.

Its SKILL.md is about 940 tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 other files, including scripts and reference files (for example `references/api_reference.md`, `scripts/edit_image.py` and `scripts/generate_image.py`).

It sits in Media & Creative, covering Image generation. It works with Google Gemini. The repository describes itself as: CrossBeam Permits — AI-assisted building-permit plan review for cities and builders. The licence is MIT.

When your agent uses it

The user asks to generate images from text prompts
Edit existing images
Modify pictures

Example prompts

“/nano-banana”

Requirements

Python 3
A credential in GEMINI_API_KEY

Workflow steps

2 steps, taken from the step headings in SKILL.md.

Text-to-Image Generation
Image Editing

What it can do on your machine

Read from SKILL.md and the folder at commit cc5591e. 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 3 files in scripts/ (Python), which the agent can run.
Shell commands in SKILL.md call:
- python
- pip
From the folder's file list and the shell code blocks in SKILL.md.
Network
Links to these hosts (documentation or services it may open):
- aistudio.google.com
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 loads about 944 tokens when it runs, and up to ~1.9k if it reads all its reference files. Until then it costs about 80 tokens; SKILL.md has 268 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~80
When it runs · the whole SKILL.md, loaded when a task matches: ~944
With references · SKILL.md plus every file in references/, read only if the agent opens them: ~1.9k

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

NoteMentions a .env fileSKILL.md:12

res a `GEMINI_API_KEY` in the project's `.env` or `.env.local` file:

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 mikeOnBreeze/cc-crossbeam at commit cc5591e, republished under its MIT licence (© mikeOnBreeze). 268 words, ~944 tokens.

Download SKILL.mdSave it as .claude/skills/nano-banana/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.

name: nano-banana
description: This skill enables image generation and editing using Google's Gemini Nano Banana models. Use this skill when the user asks to generate images from text prompts, edit existing images, or modify pictures. Supports text-to-image generation, image editing with prompts, and multi-image reference for consistency.

Nano Banana

Image generation and editing skill powered by Google Gemini's Nano Banana models.

Prerequisites

This skill requires a GEMINI_API_KEY in the project's .env or .env.local file:

env

GEMINI_API_KEY=your_api_key_here

To obtain an API key, visit: https://aistudio.google.com/apikey

Capabilities

1. Text-to-Image Generation

Generate images from text descriptions using scripts/generate_image.py:

bash

python scripts/generate_image.py "a serene Japanese garden with cherry blossoms" \
  --aspect-ratio 16:9

Parameters:

prompt (required): Text description of the image to generate
--output: Output directory or file path (default: current directory)
--filename: Custom filename (default: auto-generated with timestamp)
--aspect-ratio: Image aspect ratio (default: 1:1)
--model: Model to use (default: gemini-3-pro-image-preview)

2. Image Editing

Edit existing images with text prompts using scripts/edit_image.py:

bash

python scripts/edit_image.py "remove the background and make it transparent" \
  --images photo.png

python scripts/edit_image.py "change the sky to sunset colors" \
  --images landscape.jpg \
  --output edited_landscape.png

Multiple Image Support (for consistency/reference):

bash

python scripts/edit_image.py "create a collage combining these images" \
  --images img1.png img2.png img3.png \
  --aspect-ratio 16:9

Parameters:

prompt (required): Text description of the edit
--images (required): One or more input image paths
--output: Output directory or file path (default: current directory)
--filename: Custom filename (default: auto-generated)
--aspect-ratio: Output aspect ratio (optional)
--model: Model to use

Supported Parameters

Aspect Ratios

1:1 | 2:3 | 3:2 | 3:4 | 4:3 | 4:5 | 5:4 | 9:16 | 16:9 | 21:9

Models

gemini-3-pro-image-preview (default) - Nano Banana Pro: Higher quality, advanced reasoning, supports up to 14 reference images
gemini-2.5-flash-image - Nano Banana: Faster generation, lower cost, good for quick iterations

Usage Examples

Generate a logo:

bash

python scripts/generate_image.py "minimalist tech company logo, blue gradient, modern" \
  --aspect-ratio 1:1 --filename logo.png

Generate social media content:

bash

python scripts/generate_image.py "cozy coffee shop interior, warm lighting" \
  --aspect-ratio 9:16

Edit a product photo:

bash

python scripts/edit_image.py "place this product on a wooden table with soft lighting" \
  --images product.png --aspect-ratio 4:3

Quick iteration with Flash model:

bash

python scripts/generate_image.py "abstract art, vibrant colors" \
  --model gemini-2.5-flash-image

Resources

scripts/

generate_image.py - Text-to-image generation script
edit_image.py - Image editing with text prompts
requirements.txt - Python dependencies (install with pip install -r requirements.txt)

references/

api_reference.md - Detailed API documentation, error codes, and troubleshooting

Notes

All generated images include SynthID watermarking (invisible, added by Gemini)
Pro model supports up to 14 reference images for style/subject consistency
Images are saved as JPEG by default (based on API response)
Ensure dependencies are installed: pip install -r scripts/requirements.txt

Files

SKILL.md and 4 other files (scripts, references) in .claude/skills/nano-banana of mikeOnBreeze/cc-crossbeam.

SKILL.md
references/api_reference.md
scripts/edit_image.py
scripts/generate_image.py
scripts/requirements.txt

Open the folder on GitHubat commit cc5591e

Compare with similar skills

Nano Banana 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 compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Nano Banana this skillmikeOnBreeze/cc-crossbeam	293	—	~944	Automated safety check: Notes	MIT	7 mo ago
AI Image Generation and Editingzhayujie/CowAgent	47k	—	~1.3k	Automated safety check: Pass	MIT	yesterday
Logo Generatorop7418/logo-generator-skill	2.2k	—	~1.8k	Automated safety check: Notes	None	5 mo ago
Gemini Web Reverse-Engineered ClientJimLiu/baoyu-skills	27k	5 repos	~1.6k	Automated safety check: Pass	MIT	1 mo ago
SEO Image GeneratorAgriciDaniel/claude-seo	19k	2 repos	~2.1k	Automated safety check: Pass	MIT	6 days ago
BlockRun Image GenerationBlockRunAI/ClawRouter	6.6k	—	~2.1k	Automated safety check: Pass	MIT	6 days ago

Similar skills

AI Image Generation and Editing
zhayujie/CowAgent
Generates or edits images from text prompts through a Python script that picks an image backend based on which API keys are configured.
47k GitHub stars~1.3k tokensUpdated yesterday
Media & CreativeAuto-check passed
Logo Generator
op7418/logo-generator-skill
Generate professional SVG logos and high-end showcase images.
2.2k GitHub stars~1.8k tokensUpdated 5 mo ago
Media & CreativeAuto-check: notes
Gemini Web Reverse-Engineered Client
JimLiu/baoyu-skills
Generates text and images through an unofficial, reverse-engineered Gemini Web API, supporting reference images and multi-turn conversations.
27k GitHub starsUsed in 5 repos~1.6k tokens
Media & CreativeAuto-check passed
SEO Image Generator
AgriciDaniel/claude-seo
Generates Open Graph previews, blog hero images, product photos and infographics for SEO use through Gemini image tools and the banana extension.
19k GitHub starsUsed in 2 repos~2.1k tokens
Media & CreativeAuto-check passed
BlockRun Image Generation
BlockRunAI/ClawRouter
Generates or edits images through ClawRouter's local image API, with a choice of models and sizes and payment handled automatically through x402.
6.6k GitHub stars~2.1k tokensUpdated 6 days ago
Media & CreativeAuto-check passed
Antigravity Gemini Image
uluckyXH/OpenMOSS
Generate or edit images using the Antigravity-hosted Gemini image model via the local gateway.
1.3k GitHub stars~730 tokensUpdated 3 mo ago
Media & CreativeAuto-check: notes

Questions about Nano Banana

What does Nano Banana do?

This skill enables image generation and editing using Google's Gemini Nano Banana models. Nano Banana is an agent skill from mikeOnBreeze/cc-crossbeam. This skill enables image generation and editing using Google's Gemini Nano Banana models.

When should I use Nano Banana?

Nano Banana fits situations like: the user asks to generate images from text prompts; edit existing images; modify pictures.

How do I install Nano Banana in Claude Code?

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

How do I install Nano Banana in Codex?

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

Can I use Nano Banana 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 mikeOnBreeze/cc-crossbeam --skill nano-banana -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, .gemini/skills/nano-banana, .github/skills/nano-banana and .opencode/skills/nano-banana in your project.

What does Nano Banana need to run?

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

Does Nano Banana access the network?

SKILL.md names 1 domain. As links in the text: aistudio.google.com. This is read from the text; nothing was executed.

Is Nano Banana safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. 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 use?

Nano Banana 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 use?

About 944 tokens (SKILL.md is roughly 3.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 910 tokens, read only when the agent opens those files.

What are the alternatives to Nano Banana?

Skills that share tags, products or a category with Nano Banana: AI Image Generation and Editing (zhayujie/CowAgent, 47k stars), Logo Generator (op7418/logo-generator-skill, 2.2k stars), Gemini Web Reverse-Engineered Client (JimLiu/baoyu-skills, 27k stars) and SEO Image Generator (AgriciDaniel/claude-seo, 19k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Nano Banana?

mikeOnBreeze (a GitHub user) maintains it in mikeOnBreeze/cc-crossbeam, which has 293 GitHub stars. The repository holds 20 skills in this directory. The repository was last updated on March 2, 2026.

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

Install Nano Banana

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Nano Banana

Prerequisites

Capabilities

1. Text-to-Image Generation

2. Image Editing

Supported Parameters

Aspect Ratios

Models

Usage Examples

Resources

scripts/

references/

Notes

Files

Compare with similar skills

Similar skills

More from mikeOnBreeze/cc-crossbeam

Related

Questions about Nano Banana