manage-nano-bananalisted
Install: claude install-skill weirdapps/plessas-lab
> **Path Convention**: All paths in this document are relative to this skill's root directory. When executing commands, first `cd` to the skill directory or adjust paths accordingly.
<objective>
Enable Claude Code to create, edit, and generate visual content using Google's Nano Banana API. This skill provides prebuilt TypeScript tools to avoid code duplication and ensure consistent image generation across tasks.
</objective>
<context>
**Authentication** (two routes, auto-selected by `createClient`):
1. **Vertex AI** — preferred when a GCP project is configured. Set
`GOOGLE_CLOUD_PROJECT` (or `ANTHROPIC_VERTEX_PROJECT_ID`); auth via ADC
(`gcloud auth application-default login`). Bills the project and keeps data
in-region. On EU projects `gemini-2.5-flash-image` is served from
`europe-west1` — override with `NANO_BANANA_VERTEX_LOCATION` if your project
differs (the `eu` and `global` endpoints may be unavailable).
2. **Google AI Studio API key** — set `GEMINI_API_KEY`. Portable fallback, and
the ONLY route for `gemini-3-pro-image-preview` (not published on Vertex).
Set `NANO_BANANA_FORCE_API_KEY=true` to force the API-key route.
**Available Models**:
- `gemini-2.5-flash-image` - Fast, efficient, ~$0.039/image, 1K resolution. Runs on Vertex **or** API key.
- `gemini-3-pro-image-preview` - High quality, up to 4K, advanced text rendering, up to 14 reference images. **API key only** (no Vertex publisher entry).
**Aspect Ratios**: `1:1`, `2:3`, `3:2`, `3:4`,