nano-banana
Skill9 starsChanged 8 months agoMITView on GitHub
Generates AI images using the nano-banana CLI (Gemini 3.1 Flash default, Pro available). Handles multi-resolution (512-4K), aspect ratios, reference images for style transfer, green screen workflow for transparent assets, cost tracking, and exact dimension control. Use when asked to "generate an image", "create a sprite", "make an asset", "generate artwork", or any image generation task for UI mockups, game assets, videos, or marketing materials.
- Pipes a download into a shell
- Reads credentials
- Installs packages
40 other projects use a version of this.
Adopted by
Most recently taken up by
- okou-ai/okou-skillstheir own version, first seen Nov 11, 2026
- runapi-ai/nano-bananatheir own version, first seen Nov 8, 2026
- frontdesk-alhouse/alto-ostheir own version, first seen Nov 8, 2026
- hwangx/claude-skill-nano-bananatheir own version, first seen Nov 6, 2026
- agentrix-ai/skillstheir own version, first seen Oct 20, 2026
- Samueladewole/claude-skillsword for word, first seen Oct 13, 2026
Used with
Projects with it also use agency-docs-updater, brand-agency and 10 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
KISHOR403Skillagency-docs-updater
End-to-end pipeline for publishing Claude Code lab meetings. Automatically finds/creates Fathom transcript, downloads video, uploads to YouTube, generates fact-checked Russian summary, creates MDX documentation, and pushes to agency-docs for Vercel deployment. Single invocation replaces 5+ manual steps.
Also in 3 projects that use this
KISHOR403Skillbrand-agency
Applies Agency brand colors and typography to artifacts including presentations, SVG graphics, documents, and web interfaces. This skill should be used when brand colors, visual formatting, neobrutalism style, or Agency design standards apply. Keywords - branding, corporate identity, visual identity, styling, brand colors, typography, visual formatting, visual design, neobrutalism.
Also in 3 projects that use this
krishagelSkillelevenlabs-tts
Generate high-quality audio from text using Eleven Labs API. Use for podcasts, narration, voice-overs, and audio summaries.
Also in 5 projects that use this
- +9 more from KISHOR403
Other versions40 projects use a version of this.
Word for word · 1
- Samueladewole/claude-skills★ 0100% same
Edited · 0
None found.
Wrote their own version · 39
- OpenMinis/MinisSkills★ 612same name
- EvoScientist/EvoSkills★ 486same name
- glebis/claude-skills★ 414same name
- kkoppenhaver/cc-nano-banana★ 368same name
- mikeOnBreeze/cc-crossbeam★ 297same name
- ruizrica/agent-pi★ 274same name
- LichAmnesia/lich-skills★ 233same name
- refly-ai/refly-skills★ 204same name
- okou-ai/okou-skills★ 81same name
- vm0-ai/vm0-skills★ 81same name
29 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository28 other files it gives its agents.
- ab-test-setupSkill
- ad-creativeSkill
- analytics-trackingSkill
- cold-emailSkill
- competitive-intelligenceSkill
- content-strategySkill
- copywritingSkill
- customer-researchSkill
- email-sequenceSkill
- form-croSkill
- gtm-strategySkill
- icp-builderSkill
- keyword-researchSkill
- landing-page-generatorSkill
- launch-strategySkill
- lead-magnetsSkill
- linkedin-postsSkill
- marketing-psychologySkill
- page-croSkill
- paid-adsSkill
- pricing-strategySkill
- product-marketing-contextSkill
- qbr-narrativeSkill
- revopsSkill
- sales-enablementSkill
- seo-strategySkill
- skill-creatorSkill
- weekly-marketing-pulseSkill
The file
We split this skill into the rules it gives an agent
6 rules. 0 are common, 2 are distinctive, and 4 are very specific to this project.
0
Common
Most of the 35 edited versions we read keep these.
2
Distinctive
This author's own choices. Worth a look.
4
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 12
When the user says "init", "setup nano-banana", or "install nano-banana", run these commands to get the CLI tool on their machine.
- Very specific: line 31
After init, the user can type nano-banana "prompt" from anywhere.
- Very specific: line 33
If bun link fails or the command is not found after linking, fall back to:
- Distinctive: line 47
Default: 1K resolution, Flash model, current directory
- Very specific: line 83
Use -a flag: nano-banana "cinematic scene" -a 16:9
- Very specific: line 145
Every generation is logged to ~/.nano-banana/costs.json.
“Common” is measured: kept by at least 6 in 10 of the 35 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
nano-banana
AI image generation CLI. Default model: Gemini 3.1 Flash Image Preview (Nano Banana 2).
/init - First-Time Setup
When the user says "init", "setup nano-banana", or "install nano-banana", run these commands to get the CLI tool on their machine. No sudo required.
Prerequisites: Bun must be installed. If not: curl -fsSL https://bun.sh/install | bash
# 1. Clone the repo
git clone https://github.com/kingbootoshi/nano-banana-2-skill.git ~/tools/nano-banana-2
# 2. Install dependencies
cd ~/tools/nano-banana-2 && bun install
# 3. Link globally (creates `nano-banana` command via Bun - no sudo)
cd ~/tools/nano-banana-2 && bun link
# 4. Set up API key
mkdir -p ~/.nano-banana
echo "GEMINI_API_KEY=<ask user for their key>" > ~/.nano-banana/.envAfter init, the user can type nano-banana "prompt" from anywhere.
If bun link fails or the command is not found after linking, fall back to:
mkdir -p ~/.local/bin
ln -sf ~/tools/nano-banana-2/src/cli.ts ~/.local/bin/nano-banana
# Then ensure ~/.local/bin is on PATH:
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrcGet a Gemini API key at: https://aistudio.google.com/apikey
Quick Reference
- Command:
nano-banana "prompt" [options] - Default: 1K resolution, Flash model, current directory
Core Options
| Option | Default | Description |
-o, --output | nano-gen-{timestamp} | Output filename (no extension) |
-s, --size | 1K | Image size: 512, 1K, 2K, or 4K |
-a, --aspect | model default | Aspect ratio: 1:1, 16:9, 9:16, 4:3, 3:4, etc. |
-m, --model | flash | Model: flash/nb2, pro/nb-pro, or any model ID |
-d, --dir | current directory | Output directory |
-r, --ref | - | Reference image (can use multiple times) |
-t, --transparent | - | Generate on green screen, remove background (FFmpeg) |
--api-key | - | Gemini API key (overrides env/file) |
--costs | - | Show cost summary |
Models
| Alias | Model | Use When |
flash, nb2 | Gemini 3.1 Flash | Default. Fast, cheap (~$0.067/1K image) |
pro, nb-pro | Gemini 3 Pro | Highest quality needed (~$0.134/1K image) |
Sizes
| Size | Cost (Flash) | Cost (Pro) |
512 | ~$0.045 | Flash only |
1K | ~$0.067 | ~$0.134 |
2K | ~$0.101 | ~$0.201 |
4K | ~$0.151 | ~$0.302 |
Aspect Ratios
Supported: 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 4:5, 5:4, 21:9
Use -a flag: nano-banana "cinematic scene" -a 16:9
Key Workflows
Basic Generation
nano-banana "minimal dashboard UI with dark theme"
nano-banana "cinematic landscape" -s 2K -a 16:9
nano-banana "quick concept sketch" -s 512Model Selection
# Default (Flash - fast, cheap)
nano-banana "your prompt"
# Pro (highest quality)
nano-banana "detailed portrait" --model pro -s 2KReference Images (Style Transfer / Editing)
# Edit existing image
nano-banana "change the background to pure white" -r dark-ui.png -o light-ui
# Style transfer - multiple references
nano-banana "combine these two styles" -r style1.png -r style2.png -o combinedTransparent Assets
nano-banana "robot mascot character" -t -o mascot
nano-banana "pixel art treasure chest" -t -o chestThe -t flag automatically prompts the AI to generate on a green screen, then uses FFmpeg colorkey + despill to key out the background and remove green spill from edge pixels. Pixel-perfect transparency with no manual prompting needed.
Requires: brew install ffmpeg imagemagick
Exact Dimensions
To get a specific output dimension:
- First
-rflag: your reference/style image - Last
-rflag: blank image in target dimensions - Include dimensions in prompt
nano-banana "pixel art character in style of first image, 256x256" -r style.png -r blank-256x256.png -o spriteReference Order Matters
- First reference: primary style/content source
- Additional references: secondary influences
- Last reference: controls output dimensions (if using blank image trick)
Cost Tracking
Every generation is logged to ~/.nano-banana/costs.json. View summary:
nano-banana --costsUse Cases
- Landing page assets - product mockups, UI previews
- Image editing - transform existing images with prompts
- Style transfer - combine multiple reference images
- Marketing materials - hero images, feature illustrations
- UI iterations - quickly generate variations of designs
- Transparent assets - icons, logos, mascots with no background
- Game assets - sprites, backgrounds, characters
- Video production - visual elements for video compositions
Prompt Examples
# UI mockups
nano-banana "clean SaaS dashboard with analytics charts, white background"
# Widescreen cinematic
nano-banana "cyberpunk cityscape at sunset" -a 16:9 -s 2K
# Product shots with Pro quality
nano-banana "premium software product hero image" --model pro
# Quick low-res concept
nano-banana "rough sketch of a robot" -s 512
# Dark mode UI
nano-banana "Premium SaaS chat interface, dark mode, minimal, Linear-style aesthetic"
# Game assets with transparency (green screen auto-prompted)
nano-banana "pixel art treasure chest" -t -o chest
# Portrait aspect ratio
nano-banana "mobile app onboarding screen" -a 9:16API Key Setup
The CLI resolves the Gemini API key in this order:
--api-keyflagGEMINI_API_KEYenvironment variable.envfile in current directory.envfile next to the CLI script~/.nano-banana/.env
Get a key at: https://aistudio.google.com/apikey
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

