Banana Claude Claude skill

A Claude Code plugin that plans, generates, edits, compares and reviews Google Gemini (Nano Banana) images, with an explicit approval before each paid call.

Our verdict Recommended with caveats

A carefully built image workflow with real cost and privacy controls, but it needs a paid Gemini API key, Python 3.11 and Linux, macOS or WSL.

What Banana Claude does

Banana Claude turns a plain-language image request into a written visual brief and an exact prompt. It then shows a plan with the model, data settings, output destination and a nominal cost estimate. Planning and estimation run offline. Each paid Gemini call needs a single-use approval that expires after 30 minutes, and every retry or regeneration needs a new plan and a new approval.

The one banana skill takes subcommands for generate, edit, continue, portfolio, typeset, preset, cost and doctor. Portfolio compares up to three prompts across three model routes. Typeset adds approved copy, fonts and logos locally when the text must be exact. Continue reuses stored Nano Banana 2.1 or Pro sessions. The default route is Nano Banana 2.1, with Nano Banana 2 Lite and Pro as alternatives. Each image is saved with a metadata sidecar and stays marked as needing review until the agent has inspected the pixels.

The SKILL.md runs about 18 KB. It is backed by 8 reference files covering prompt craft, model pricing, MCP tool contracts and post-processing, plus 12 Python scripts, a test suite and a CI validation workflow. The skill also requires a written rights and likeness statement before it will send uploaded assets to Google.

Good for

  • Generating hero images, covers and product shots from inside Claude Code
  • Teams that want a cost estimate and an approval step before every paid image call
  • Keeping a character or product consistent across a series of images

Not for

  • Native Windows users who cannot use WSL
  • Anyone without a billing-enabled Google AI project
  • Unattended batch generation, since every call needs approval

What's inside depth 4/5

One 18 KB skill with 8 reference files, 12 Python scripts, a test suite and a CI validation workflow, though no evals of the skill's output quality.

Skills
1
Reference docs
8
Scripts
12
Tests / evals
0
Templates
0
Avg SKILL.md
17.4 KB

Counted from the repository file tree. How we score depth.

Dependencies and costs

  • Gemini API key for a billing-enabled Google AI project (paid per request)
  • Claude Code 2.1.199 or newer
  • Python 3.11 or newer on PATH
  • Linux or macOS; native Windows unsupported, use WSL

Security review

Review before installing

This plugin plans and runs image generation and editing through Google's Gemini API using your Gemini API key. Before each paid call it shows a plan and requires a single-use approval ID. Prompts and any reference images you attach are sent to Google. It stores approval and cost state under ~/.banana, saves images to ~/Documents/banana-claude by default, and the optional standalone installer writes to ~/.claude/skills. Several large scripts, including the MCP server and the legacy-cleanup tool that touches Claude settings, were not fully reviewed.

Worth knowing

  • Needs an API key for its own serviceRequires a Gemini API key, passed to the bundled MCP server as GEMINI_API_KEY; per the changelog it is sent to Google in the x-goog-api-key header..mcp.json:9
  • Makes network requestsBuilds HTTPS requests to generativelanguage.googleapis.com after an approval ID is consumed; prompts and any reference images you supply are sent to Google.skills/banana/scripts/banana_core.py:2089
  • Changes files outside your projectThe standalone installer writes the skill into ~/.claude/skills/banana; scripts also keep state in ~/.banana and save outputs to ~/Documents/banana-claude by default.install.sh:8

What we checked

The repository (68 files) on Oct 29, 2026. Not a full review: we read 9 of 31 code files; it relies on code outside the repository: skills/banana/scripts/banana_core.py beyond the truncated portion provided (the provider client and execution logic); skills/banana/scripts/cost_tracker.py beyond the truncated portion provided; skills/banana/scripts/mcp_server.py.

NVIDIA SkillSpector static scan: 61 pattern hits (Memory Poisoning 21, Dangerous Code Execution 19, Agent Snooping 9, Data Exfiltration 4, Tool Misuse 2, System Prompt Leakage 1). Most SkillSpector hits are documentation wording (changelog 'reset state', SECURITY.md mentions of ~/.claude/settings.json and the legacy 'npx -y @ycse/nanobanana-mcp' server it detects for cleanup) or test code: a base64 JPEG fixture, os.environ.copy() and subprocess calls in tests, and a prompt-injection string used as a negative test case. The getattr calls in banana_core.py are ordinary errno/os flag lookups.

A review, not a certification. Skills change after we check them — read the files before installing.

License

MIT, commercial use allowed.

Can it run unattended?

Not really. It is interactive by design: each paid provider attempt needs a fresh human approval that expires after 30 minutes, and it never retries on its own.

Alternatives to Banana Claude

Wonda CLI

degausai/wonda

A paid CLI and 258 KB skill for AI image, video and audio generation, social publishing and logged-in LinkedIn, X and Reddit automation.

Skip Broad access Depth 2/5

Monocolor Editorial Print (mono-color)

yanliudesign/mono-color-skill

A skill that turns a theme or photo into a one-ink or two-ink editorial print image: halftone, warm paper, strong type and generous negative space.

Recommended Check first Depth 4/5

FAQ

What is Banana Claude?

Banana Claude is an MIT-licensed Claude Code plugin by AgriciDaniel for creating, editing, comparing and reviewing images with Google's Gemini Nano Banana models. It plans each request offline, shows the prompt and cost estimate, and waits for your approval before making a paid call.

How do I install Banana Claude?

In Claude Code, run /plugin marketplace add AgriciDaniel/banana-claude, then /plugin install banana-claude@banana-claude-marketplace and /plugin enable banana-claude@banana-claude-marketplace, then /reload-plugins. The plugin installs disabled because image generation is paid. After enabling it, call it with /banana-claude:banana followed by your request.

Does Banana Claude cost money?

Yes. It needs a Gemini API key for a billing-enabled Google AI project, and each generation, edit, retry or continuation is a paid provider call. Planning and cost estimation run locally and are free, and the plan shows a nominal estimate before you approve.

Does Banana Claude work on Windows?

Not natively. Output publication needs an atomic no-replace rename that the client does not implement on Windows, so planning fails before any provider call. The README recommends running it under WSL.

Sources: GitHub repository (stars, license, file tree, last push Oct 23, 2026). Review based on the README and SKILL.md files as published.