Nano Banana (cc-nano-banana) skill

Nano Banana

Claude Code draws and edits images, icons, diagrams and patterns through the nanobanana extension for Gemini CLI

  • 383 ★ on the repository
  • Last commit
  • MIT
Skill

Broad access

Why this level

  • Gemini CLI runs with the `--yolo` flag, which approves all tool actions without asking
  • Prompts and source images go to Google, and every frame is billed against the key
All reasons and checks
Needs a VPN

kkoppenhaver/cc-nano-banana

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add skills/nano-banana

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Broad accessThe tool can change data, run commands or handle secrets.

  • Gemini CLI runs with the `--yolo` flag, which approves all tool actions without asking
  • Prompts and source images go to Google, and every frame is billed against the key

This is third-party code. Review the repository files before installing.

What it does

The skill connects Claude Code to the nanobanana extension for Gemini CLI. When you ask for a picture, a cover, a YouTube thumbnail, an app icon, a diagram or a seamless texture, Claude Code runs `gemini` and picks the right command: `/generate` for an image from a description, `/edit` to change an existing file, `/restore` to fix old photographs, and `/icon`, `/diagram`, `/pattern` and `/story` for a series of linked frames. `/nanobanana` takes a free-form request. The commands share options: `--count=N` makes 1 to 8 variations, `--preview` opens the result, `--styles="style1,style2"` sets styles and `--seed=N` makes output repeatable. Finished files land in `./nanobanana-output/` in the current project. The default model is `gemini-2.5-flash-image`, and for higher quality the `NANOBANANA_MODEL` variable switches it to `gemini-3-pro-image-preview`. In `SKILL.md` the skill calls itself required for any image request and tells Claude Code not to use other generation methods.

Who it is for. Developers, bloggers and designers who work in Claude Code and want illustrations and icons dropped into the project, and who hold a Google AI Studio key.

Good fit when

  • A blog post needs a cover and it is generated from the terminal beside the text
  • An app needs an icon or favicon and no designer is at hand
  • An old scratched photograph is restored with `/restore`
  • A service architecture has to be shown as a flowchart and `/diagram` draws it
  • A site background needs a repeating texture and `/pattern` makes it

Not a fit when

  • You need exact vector graphics or a brand style: the skill outputs raster images from a Gemini model
  • Gemini CLI cannot be installed on the machine and a Google AI Studio key is unavailable
  • The agent must not run commands without your approval: the skill requires the `--yolo` flag
  • You need steady maintenance: the repository's last commit is from February 2026

Example request

Make a cover for an article about machine learning in our site colors: dark background, three variations, save to nanobanana-output

Limitations

The skill does not work without Gemini CLI (`npm install -g @google/gemini-cli`), the nanobanana extension and a Google AI Studio key. The README names the variable `NANOBANANA_GEMINI_API_KEY` while the check in `SKILL.md` looks for `GEMINI_API_KEY`, so set both. Every frame costs money: about 0.04 dollars per image by default. Gemini CLI runs with the `--yolo` flag, which approves all tool actions on its own. The repository's last commit is from February 2026, and the nanobanana extension evolves separately and may change its commands. The skill insists that Claude Code use it for every image request.

How to disable. Delete the `~/.claude/skills/nano-banana` folder. Remove the nanobanana extension with Gemini CLI tools; `gemini extensions list` shows installed extensions. Unset `NANOBANANA_GEMINI_API_KEY`, `GEMINI_API_KEY` and `NANOBANANA_MODEL`. Finished images stay in each project's `./nanobanana-output/`.

FAQ

How do I connect Nano Banana to Claude Code?

Install Gemini CLI, get a Google AI Studio key, install the nanobanana extension with `gemini extensions install`, then copy `SKILL.md` into `~/.claude/skills/nano-banana/` or clone the repository into that folder.

Which commands does the skill add?

`/generate`, `/edit`, `/restore`, `/icon`, `/diagram`, `/pattern`, `/story` and the free-form `/nanobanana`. Claude Code picks the command from the wording of your request.

How much does one image cost?

Per the README the `gemini-2.5-flash-image` model costs about 0.04 dollars per image. Setting `NANOBANANA_MODEL=gemini-3-pro-image-preview` turns on a higher quality model, and the README gives no price for it.

Where are images saved?

In `./nanobanana-output/` in the working directory Claude Code was started from. The `--preview` flag also opens the result.

How do I get several variants or repeat a result?

`--count=N` creates 1 to 8 variations per request, `--styles="style1,style2"` sets styles and `--seed=N` makes the result reproducible.

Discussion

No questions or reviews yet.

Skills
Needs a VPN

A CLI and Claude Code skill for Gemini images from 512 to 4K, with reference-based edits and transparent assets

SkillBroad access418Repository stars

An MCP server for generating and editing images with Gemini: picks the model per request, renders up to 4K in any aspect ratio

MCP serverExtended access405Repository stars

Nano Banana Pro Prompts Recommend

AI Image Prompt Recommender

A skill that picks ready image-generation prompts from a large library, shows sample images and assembles a prompt for your text

SkillExtended access1.9KRepository stars
Needs a VPN

A Claude Code skill for generating, editing and reviewing images with Google Gemini models, with a plan and approval before every paid request

SkillBroad access1.2KRepository stars
Needs a VPN

A Claude Code skill that turns a document into image slides via Gemini and builds a video with Kling AI transitions

SkillExtended access3.4KRepository stars

Over 1,400 popular prompts for NanoBanana and GPT Image from X posts ranked by likes, plus a system prompt that turns a short idea into a detailed one

PromptMinimal access750Repository stars

Comparison with similar tools

Cards that share the main search query, and how they differ.

ToolOfficialAuthenticationRepository starsMain difference
Nano Banana (cc-nano-banana) (this card)no383
Nano Banana 2 Skillno418a console utility with sizes from 512 to 4K and transparent assets; here the nanobanana extension commands for Gemini CLI
Nano Banana MCP ServernoAPI key405an MCP server that picks a Gemini model itself; here a skill on top of Gemini CLI

README in short

The page lists what the skill can do, its prerequisites and three install steps. Then come example requests, tables of commands and shared options, where results are saved and how to pick a model.

README badge

Original SKILL.md

---
name: nano-banana
description: REQUIRED for all image generation requests. Generate and edit images using Nano Banana (Gemini CLI). Handles blog featured images, YouTube thumbnails, icons, diagrams, patterns, illustrations, photos, visual assets, graphics, artwork, pictures. Use this skill whenever the user asks to create, generate, make, draw, design, or edit any image or visual content.
allowed-tools: Bash(gemini:*)
---

# Nano Banana Image Generation

Generate professional images via the Gemini CLI's nanobanana extension.

## When to Use This Skill

ALWAYS use this skill when the user:
- Asks for any image, graphic, illustration, or visual
- Wants a thumbnail, featured image, or banner
- Requests icons, diagrams, or patterns
- Asks to edit, modify, or restore a photo
- Uses words like: generate, create, make, draw, design, visualize

Do NOT attempt to generate images through any other method.

## Before First Use

1. Verify extension is installed:
   ```bash
   gemini extensions list | grep nanobanana
   ```
2. If missing, install it:
   ```bash
   gemini extensions install https://github.com/gemini-cli-extensions/nanobanana
   ```
3. Verify API key is set:
   ```bash
   [ -n "$GEMINI_API_KEY" ] && echo "API key configured" || echo "Missing GEMINI_API_KEY"
   ```

## Command Selection

| User Request | Command |
|--------------|---------|
| "make me a blog header" | `/generate` |
| "create an app icon" | `/icon` |
| "draw a flowchart of..." | `/diagram` |
| "fix this old photo" | `/restore` |
| "remove the background" | `/edit` |
| "create a repeating texture" | `/pattern` |
| "make a comic strip" | `/story` |

## Available Commands

Report a problem