Index of every page on this site: llms.txt
All skills
kingbootoshi avatar

/nano-banana

@80bab9a
Run it yourself

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.

Use this Skill: https://skilld.dev/gh/kingbootoshi/nano-banana-2-skill/nano-banana

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈116 tokens for metadata: the name and description. ≈1.4k when used: this file.

Description uses 5.8% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈464 characters, or 5.8%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

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/.env

After 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 ~/.zshrc

Get 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 512

Model Selection

# Default (Flash - fast, cheap)
nano-banana "your prompt"

# Pro (highest quality)
nano-banana "detailed portrait" --model pro -s 2K

Reference 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 combined

Transparent Assets

nano-banana "robot mascot character" -t -o mascot
nano-banana "pixel art treasure chest" -t -o chest

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

  1. First -r flag: your reference/style image
  2. Last -r flag: blank image in target dimensions
  3. Include dimensions in prompt
nano-banana "pixel art character in style of first image, 256x256" -r style.png -r blank-256x256.png -o sprite

Reference 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 --costs

Use 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:16

API Key Setup

The CLI resolves the Gemini API key in this order:

  1. --api-key flag
  2. GEMINI_API_KEY environment variable
  3. .env file in current directory
  4. .env file next to the CLI script
  5. ~/.nano-banana/.env

Get a key at: https://aistudio.google.com/apikey

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

3 warnings2mo5 checks · Risk SAFE
  • Gen Agent Trust Hub2mo

    The skill is safe to use. It provides instructions to install and use a command-line interface (CLI) tool for generating AI images via the Gemini API. The setup process involves installing the Bun runtime from a well-known source, cloning the author's own repository, and optionally updating the system PATH via the shell profile, all of which represent standard development workflows.

  • Socket2mo

    1 alert: gptSecurity

  • Snyk2mo

    Risk: MEDIUM · 1 issue

  • Runlayer8mo

    1/1 file flagged

  • ZeroLeaks7mo

    1 finding · Score: 82/100

Signed by skilld at 80bab9a. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub last month.

Activeupdated 9 months ago

README badge

README badge for kingbootoshi/nano-banana-2-skill