Agent skill

Nano Banana

by kkoppenhaver in kkoppenhaver/cc-nano-banana

REQUIRED for all image generation requests. An agent skill from kkoppenhaver/cc-nano-banana.

MITAuto-check passedMedia & Creative

Install Nano Banana

skills CLI
$ npx skills add kkoppenhaver/cc-nano-banana --skill nano-banana -a claude-code

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

GitHub CLI
$ gh skill install kkoppenhaver/cc-nano-banana 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).

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
nano-banana
GitHub stars
378
Used in
1 other repo
Token cost
~1.4k tokens
SKILL.md length
462 words
Files
3
Skills in repo
1
Repo updated
First seen
Licence
MIT

At a glance

REQUIRED for all image generation requests. An agent skill from kkoppenhaver/cc-nano-banana.

  • Works in 3 steps: Verify extension is installed → If missing, install it → Verify API key is set
  • The user asks to create
  • SKILL.md covers When to Use This Skill, Before First Use, Command Selection and Available Commands, plus 11 more sections
  • Calls gemini; reaches github.com; needs GEMINI_API_KEY

What it does

Nano Banana is an agent skill from kkoppenhaver/cc-nano-banana. 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.

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `README.md`).

It sits in Media & Creative, covering Image generation and Diagrams. It works with Google Gemini and YouTube. The repository describes itself as: A Claude Code skill to generate images with Nano Banana. The licence is MIT.

When your agent uses it

  • The user asks to create
  • Tasks that involve Image generation
  • Tasks that involve Diagrams

Example prompts

  • “/nano-banana”

Requirements

  • A credential in GEMINI_API_KEY
  • Pre-approved tools (allowed-tools): Bash(gemini:*)

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Verify extension is installed
  2. If missing, install it
  3. Verify API key is set

What it can do on your machine

Read from SKILL.md and the folder at commit 3b13699. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash(gemini:*)

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • gemini

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • github.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 1.4k tokens when it runs. Until then it costs about 93 tokens; SKILL.md has 462 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~93
When it runs · the whole SKILL.md, loaded when a task matches
~1.4k

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 passed

The automated check found no risky patterns in SKILL.md.

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from kkoppenhaver/cc-nano-banana at commit 3b13699, republished under its MIT licence (© kkoppenhaver). 462 words, ~1,387 tokens.

Download SKILL.mdSave it as .claude/skills/nano-banana/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
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 RequestCommand
"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

Note: Always use the --yolo flag to automatically approve all tool actions.

CommandUse Case
gemini --yolo "/generate 'prompt'"Text-to-image generation
gemini --yolo "/edit file.png 'instruction'"Modify existing image
gemini --yolo "/restore old_photo.jpg 'fix scratches'"Repair damaged photos
gemini --yolo "/icon 'description'"App icons, favicons, UI elements
gemini --yolo "/diagram 'description'"Flowcharts, architecture diagrams
gemini --yolo "/pattern 'description'"Seamless textures and patterns
gemini --yolo "/story 'description'"Sequential/narrative images
gemini --yolo "/nanobanana prompt"Natural language interface

Common Options

  • --yolo - Required. Auto-approve all tool actions (no confirmation prompts)
  • --count=N - Generate N variations (1-8)
  • --preview - Auto-open generated images
  • --styles="style1,style2" - Apply artistic styles
  • --format=grid|separate - Output arrangement

Common Sizes

Use CaseDimensionsNotes
YouTube thumbnail1280x720--aspect=16:9
Blog featured image1200x630Social preview friendly
Square social1080x1080Instagram, LinkedIn
Twitter/X header1500x500Wide banner
Vertical story1080x1920--aspect=9:16
Show full SKILL.md (196 more words)Show less

Model Selection

Default: gemini-2.5-flash-image (~$0.04/image)

For higher quality (4K, better reasoning):

bash
export NANOBANANA_MODEL=gemini-3-pro-image-preview
bash
# Modern illustration style
gemini --yolo "/generate 'modern flat illustration of developer coding at laptop, purple and blue gradient background, minimalist style, no text' --preview"

# Professional photography style
gemini --yolo "/generate 'professional editorial photo of coffee cup next to laptop on wooden desk, morning sunlight, shallow depth of field, no text' --count=3"

# Tech/abstract
gemini --yolo "/generate 'abstract visualization of neural network connections, dark background with glowing blue nodes, futuristic style' --preview"

Icon Generation

bash
gemini --yolo "/icon 'minimalist app logo for productivity tool' --sizes='64,128,256,512' --type='app-icon' --corners='rounded'"

Diagram Generation

bash
gemini --yolo "/diagram 'user authentication flow with OAuth' --type='flowchart' --style='modern'"

Output Location

All generated images are saved to ./nanobanana-output/ in the current directory.

Presenting Results

After generation completes:

  1. List contents of ./nanobanana-output/ to find generated files
  2. Present the most recent image(s) to the user
  3. Offer to regenerate with variations if needed

Refinements and Iterations

When the user asks for changes:

  • "Try again" / "Give me options": Regenerate with --count=3
  • "Make it more [adjective]": Adjust prompt and regenerate
  • "Edit this one": Use gemini --yolo "/edit nanobanana-output/filename.png 'adjustment'"
  • "Different style": Add --styles="requested_style" to the command

Prompt Tips

  1. Be specific: Include style, mood, colors, composition details
  2. Add "no text": If you don't want text rendered in the image
  3. Reference styles: "editorial photography", "flat illustration", "3D render", "watercolor"
  4. Specify aspect ratio context: "wide banner", "square thumbnail", "vertical story"

Troubleshooting

ProblemSolution
GEMINI_API_KEY not setexport GEMINI_API_KEY="your-key"
Extension not foundRun install command from setup section
Quota exceededWait for reset or switch to flash model
Image generation failedCheck prompt for policy violations, simplify request
Output directory missingWill be created automatically on first run

© kkoppenhaver, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files in the repository root of kkoppenhaver/cc-nano-banana.

  • SKILL.md
  • LICENSE
  • README.md

Open the folder on GitHubat commit 3b13699

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in kkoppenhaver/cc-nano-banana, which our catalogue first saw on October 7, 2026.

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
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Nano Banana this skillkkoppenhaver/cc-nano-banana3781 repos~1.4kAutomated safety check: PassMIT
Nano Bananajh941213/my-cc-harness125—~1kAutomated safety check: PassNone
AI MultimodalMicrock/ordinary-claude-skills404—~2.7kAutomated safety check: NotesMIT
Imagensanjay3290/ai-skills4326 repos~657Automated safety check: PassApache-2.0
Smart Illustratoraxtonliu/smart-illustrator564—~1.8kAutomated safety check: PassMIT
FigureMuuuun/luxas1.2k—~1.2kAutomated safety check: PassMIT

Similar skills

  • Nano Banana

    jh941213/my-cc-harness

    REQUIRED for all image generation requests. An agent skill from jh941213/my-cc-harness.

    125 GitHub stars~1k tokensUpdated 2 mo ago
    Media & CreativeAuto-check passed
  • AI Multimodal

    Microck/ordinary-claude-skills

    Process and generate multimedia content using Google Gemini API.

    404 GitHub stars~2.7k tokensUpdated 1 mo ago
    Media & CreativeAuto-check: notes
  • Imagen

    sanjay3290/ai-skills

    Generate images using Google Gemini's image generation capabilities.

    432 GitHub starsUsed in 6 repos~657 tokens
    Media & CreativeAuto-check passed
  • Smart Illustrator

    axtonliu/smart-illustrator

    Generates article illustrations, batch slide infographics and cover images from your text, using Gemini, Mermaid or Excalidraw engines and a prompt-only mode.

    564 GitHub stars~1.8k tokensUpdated 3 mo ago
    Media & CreativeAuto-check passed
  • Figure

    Muuuun/luxas

    Hybrid figure pipeline (Nano Banana raster + rembg background removal + TikZ vector assembly).

    1.2k GitHub stars~1.2k tokensUpdated 1 mo ago
    Media & CreativeAuto-check passed
  • Generate Youtube Thumbnail

    krusemediallc/arcads-claude-code

    Generate high-CTR YouTube thumbnails using Nano Banana 2 via the Arcads external API.

    1.6k GitHub stars~2.4k tokensUpdated 18 days ago
    Media & CreativeAuto-check: notes

Questions about Nano Banana

What does Nano Banana do?

REQUIRED for all image generation requests. An agent skill from kkoppenhaver/cc-nano-banana. Nano Banana is an agent skill from kkoppenhaver/cc-nano-banana. REQUIRED for all image generation requests.

When should I use Nano Banana?

Nano Banana fits situations like: the user asks to create; tasks that involve Image generation; tasks that involve Diagrams.

How do I install Nano Banana in Claude Code?

Run `npx skills add kkoppenhaver/cc-nano-banana --skill nano-banana -a claude-code`. Or copy the skill folder (the kkoppenhaver/cc-nano-banana repository) 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 kkoppenhaver/cc-nano-banana --skill nano-banana -a codex`. Or copy the skill folder (the kkoppenhaver/cc-nano-banana repository) 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 kkoppenhaver/cc-nano-banana --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 the command-line tools its instructions call (gemini) and credentials named GEMINI_API_KEY. Our summary lists: A credential in GEMINI_API_KEY. Its frontmatter pre-approves these tools: Bash(gemini:*).

Does Nano Banana access the network?

SKILL.md names 1 domain. In commands or code: github.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Nano Banana safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Nano Banana use?

Nano Banana is published under the MIT licence (from the LICENSE file in the skill folder). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Nano Banana use?

About 1.4k tokens (SKILL.md is roughly 5.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Nano Banana?

Skills that share tags, products or a category with Nano Banana: Nano Banana (jh941213/my-cc-harness, 125 stars), AI Multimodal (Microck/ordinary-claude-skills, 404 stars), Imagen (sanjay3290/ai-skills, 432 stars) and Smart Illustrator (axtonliu/smart-illustrator, 564 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Nano Banana?

kkoppenhaver (a GitHub user) maintains it in kkoppenhaver/cc-nano-banana, which has 378 GitHub stars. The repository was last updated on May 20, 2026.

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