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
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
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/nano-bananaDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewBroad 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-outputLimitations
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.
Related
SkillsA CLI and Claude Code skill for Gemini images from 512 to 4K, with reference-based edits and transparent assets
An MCP server for generating and editing images with Gemini: picks the model per request, renders up to 4K in any aspect ratio
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
A Claude Code skill for generating, editing and reviewing images with Google Gemini models, with a plan and approval before every paid request
A Claude Code skill that turns a document into image slides via Gemini and builds a video with Kling AI transitions
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
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Authentication | Repository stars | Main difference |
|---|---|---|---|---|
| Nano Banana (cc-nano-banana) (this card) | no | 383 | ||
| Nano Banana 2 Skill | no | 418 | a console utility with sizes from 512 to 4K and transparent assets; here the nanobanana extension commands for Gemini CLI | |
| Nano Banana MCP Server | no | API key | 405 | an 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