Banana Claude

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

Skill

High risk

We rate an entry high when the tool writes to external systems, handles money, production databases or secrets, or runs arbitrary commands. The CLI installs it only with your consent.

Why this level

  • Makes paid requests to the external Gemini API, and each attempt costs money
  • Handles a sensitive Google key and writes generated files to disk
All reasons and checks
Needs a VPN

agricidaniel/banana-claude

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add skills/banana-claude

Detects the agents on your machine, checks the risk and pins the version.

Other ways to install

Run in a terminal in the project folder

npx skills add agricidaniel/banana-claude --skill banana -a claude-code -y

The skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.

Without third-party tools, from commit 6a2b1b5
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/agricidaniel/banana-claude.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/banana/
git -C "$tmp" checkout 6a2b1b51fdcc35932184f06e513646a6f6f4f7d8
mkdir -p .claude/skills
cp -R "$tmp/skills/banana" .claude/skills/banana

Commands for macOS and Linux, on Windows run them in Git Bash.

Run in a terminal in the project folder

npx skills add agricidaniel/banana-claude --skill banana -a cursor -y

The skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.

Without third-party tools, from commit 6a2b1b5
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/agricidaniel/banana-claude.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/banana/
git -C "$tmp" checkout 6a2b1b51fdcc35932184f06e513646a6f6f4f7d8
mkdir -p .agents/skills
cp -R "$tmp/skills/banana" .agents/skills/banana

Commands for macOS and Linux, on Windows run them in Git Bash.

Run in a terminal in the project folder

npx skills add agricidaniel/banana-claude --skill banana -a github-copilot -y

The skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.

Without third-party tools, from commit 6a2b1b5
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/agricidaniel/banana-claude.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/banana/
git -C "$tmp" checkout 6a2b1b51fdcc35932184f06e513646a6f6f4f7d8
mkdir -p .github/skills
cp -R "$tmp/skills/banana" .github/skills/banana

Commands for macOS and Linux, on Windows run them in Git Bash.

Run in a terminal in the project folder

npx skills add agricidaniel/banana-claude --skill banana -a codex -y

The skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.

Without third-party tools, from commit 6a2b1b5
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/agricidaniel/banana-claude.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/banana/
git -C "$tmp" checkout 6a2b1b51fdcc35932184f06e513646a6f6f4f7d8
mkdir -p .agents/skills
cp -R "$tmp/skills/banana" .agents/skills/banana

Commands for macOS and Linux, on Windows run them in Git Bash.

Run in a terminal in the project folder

npx skills add agricidaniel/banana-claude --skill banana -a gemini-cli -y

The skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.

Without third-party tools, from commit 6a2b1b5
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/agricidaniel/banana-claude.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/banana/
git -C "$tmp" checkout 6a2b1b51fdcc35932184f06e513646a6f6f4f7d8
mkdir -p .agents/skills
cp -R "$tmp/skills/banana" .agents/skills/banana

Commands for macOS and Linux, on Windows run them in Git Bash.

Run in a terminal in the project folder

tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/agricidaniel/banana-claude.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/banana/
git -C "$tmp" checkout 6a2b1b51fdcc35932184f06e513646a6f6f4f7d8
mkdir -p .devin/skills
cp -R "$tmp/skills/banana" .devin/skills/banana

Commands for macOS and Linux, on Windows run them in Git Bash.

Formerly Windsurf.

Run in a terminal in the project folder

npx skills add agricidaniel/banana-claude --skill banana -a cline -y

The skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.

Without third-party tools, from commit 6a2b1b5
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/agricidaniel/banana-claude.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/banana/
git -C "$tmp" checkout 6a2b1b51fdcc35932184f06e513646a6f6f4f7d8
mkdir -p .cline/skills
cp -R "$tmp/skills/banana" .cline/skills/banana

Commands for macOS and Linux, on Windows run them in Git Bash.

Run in a terminal in the project folder

npx skills add agricidaniel/banana-claude --skill banana -a roo -y

The skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.

Without third-party tools, from commit 6a2b1b5
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/agricidaniel/banana-claude.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/banana/
git -C "$tmp" checkout 6a2b1b51fdcc35932184f06e513646a6f6f4f7d8
mkdir -p .roo/skills
cp -R "$tmp/skills/banana" .roo/skills/banana

Commands for macOS and Linux, on Windows run them in Git Bash.

A fork of Roo Code, same .roo folders.

Run in a terminal in the project folder

npx skills add agricidaniel/banana-claude --skill banana -a opencode -y

The skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.

Without third-party tools, from commit 6a2b1b5
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/agricidaniel/banana-claude.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/banana/
git -C "$tmp" checkout 6a2b1b51fdcc35932184f06e513646a6f6f4f7d8
mkdir -p .agents/skills
cp -R "$tmp/skills/banana" .agents/skills/banana

Commands for macOS and Linux, on Windows run them in Git Bash.

Run in a terminal in the project folder

tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/agricidaniel/banana-claude.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/banana/
git -C "$tmp" checkout 6a2b1b51fdcc35932184f06e513646a6f6f4f7d8
mkdir -p .agents/skills
cp -R "$tmp/skills/banana" .agents/skills/banana

Commands for macOS and Linux, on Windows run them in Git Bash.

Run in a terminal in the project folder

tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/agricidaniel/banana-claude.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/banana/
git -C "$tmp" checkout 6a2b1b51fdcc35932184f06e513646a6f6f4f7d8
mkdir -p .agents/skills
cp -R "$tmp/skills/banana" .agents/skills/banana

Commands for macOS and Linux, on Windows run them in Git Bash.

You will need: Node.js

Checked against the repository on Sep 24, 2026, commit 6a2b1b5.

Text for your agent

Install the plugin: /plugin marketplace add AgriciDaniel/banana-claude, then /plugin install banana-claude@banana-claude-marketplace, enable it with /plugin enable banana-claude@banana-claude-marketplace and run /reload-plugins. Set the Gemini key in the plugin settings, then call /banana-claude:banana.

Other ways from the author
/plugin marketplace add AgriciDaniel/banana-claude
/plugin install banana-claude@banana-claude-marketplace
/plugin enable banana-claude@banana-claude-marketplace
/reload-plugins

The plugin installs disabled; enable it and set the Gemini key in the plugin settings.

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

What it does

The skill turns a plain-language request into a visual brief, compiles the exact prompt, shows the plan and an estimate, and only after approval sends a paid request to Google Gemini models. It can generate images, make one change while protecting geometry and details, continue a session with prior settings, compare up to three prompts across model routes, and review a finished result for composition, text and rights. The Gemini key never reaches commands, URLs or metadata, and one approval permits one provider attempt. A result is not treated as done until the user inspects the actual pixels. A metadata sidecar is saved next to the image without the raw prompt.

Who it is for. For designers, marketers and content creators who generate and edit images directly in Claude Code.

Good fit when

  • You need to generate a visual from a text description
  • You need to change one detail in an image cleanly
  • You need to compare several prompts and models in one pass
  • You need to review a finished result for composition, text and rights

Not a fit when

  • You have no Gemini key and no billing on a Google AI project
  • You need free image generation
  • You have no access to Google services from your network

Example request

Generate a 16:9 GitHub hero with clean copy space on the left

Limitations

You need a Gemini key for a billing-enabled Google AI project, and every request is paid. It requires Claude Code 2.1.199 or newer and Python 3.11 with python3 on PATH. Google AI services are unavailable from Russia without a VPN, so the skill will not work without one. Gemini output is probabilistic: the skill does not guarantee text accuracy, geometry, clean rights or the final invoice, and those stay on the user's review.

How to disable. Disable or remove the banana-claude plugin via /plugin. For a manual install, delete the banana skill folder from the skills directory and the banana MCP entry from the configuration.

Security check

  • Makes paid requests to the external Gemini API, and each attempt costs money
  • Handles a sensitive Google key and writes generated files to disk

README in short

The README describes a skill that runs Gemini image generation through explicit steps: ask, plan, review the plan, approve, create, inspect the pixels. The plugin installs via /plugin marketplace add and comes disabled because generation is paid. The Gemini key is set as a sensitive value and never reaches commands or logs. It routes across the Nano Banana 2 Lite, Nano Banana 2 and Nano Banana Pro models. There is a separate guide, prompt and model references, and compare and typeset modes. MIT licensed, version 3.

SKILL.md

---
name: banana
description: "Direct, generate, edit, compare, and review visual assets with current Google Gemini image models. Use for image creation, image editing, reference-based consistency, product and character visuals, text-bearing graphics, grounded diagrams, video-derived images, and multi-model image portfolios."
argument-hint: "[generate|edit|continue|portfolio|typeset|preset|cost|doctor] <request>"
metadata:
  version: "3.0.0"
  author: AgriciDaniel
  provider: Google Gemini Developer API
---

# Banana Claude

Turn user intent into a frozen visual brief, compile the exact prompt, plan the
request, obtain approval, execute through the bundled Gemini client, and inspect
the actual pixels. The prompt is a control artifact, not the finished work.

Plugin command: /banana-claude:banana. The standalone install uses /banana and
the direct scripts, without plugin MCP or plugin-managed secrets.

## Non-negotiable boundaries

- Planning, prompt work, model inspection, and cost estimation do not call
  Google. Planning does write a short-lived approval capability to private
  local state.
- Before every paid provider attempt, show the exact plan and receive clear
  user approval after disclosure. An approval ID is a single-use capability,
  not proof that a human reviewed the plan. It expires after 30 minutes and is
  consumed before the attempt.
- Never request, print, put on a command line, or write an API key. Plugin
  configuration supplies it as sensitive user configuration. Standalone
  scripts read only GEMINI_API_KEY and ignore generic Google key aliases.

FAQ

How much does it cost?

Every Gemini request is paid at Google's rates. The skill shows the plan and estimate before payment, while planning and prompt work are free.

Where is the key stored?

The key is set as a sensitive plugin value and is never written into commands, URLs or metadata.

Editors’ pick

Skills and CLI from HeyGen: the agent writes HTML compositions and renders them into MP4 videos, captions, motion graphics and decks

SkillMedium risk53.9KRepository stars

Blender MCP

MCP for Blender

Editors’ pick

An MCP server and Blender addon: the agent creates and edits objects, materials and scenes, pulls assets and runs Python in Blender

MCP serverHigh risk29.5KRepository stars
Editors’ pick

Official Remotion skills for making videos in React: compositions, animation, captions, maps and rendering

SkillLow risk4.8KRepository stars

Agentic video studio for Claude Code, Cursor and Codex: script, voiceover, images, stock footage, music, subtitles and render

WorkflowMedium risk61.8KRepository stars
Foxx AIBanana Claude

I am Foxx AI and I have already vetted this tool. Ask about install, setup or anything else, and I will keep it simple.