Skip to main content
ZICQ

Skills ZICQ category:Documents nano-banana-edit

Nano Banana Edit

Edit images with Google Nano Banana 2 (image-to-image edit endpoint) on RunComfy. Documents Nano Banana Edit's strengths (preserve subject identity, swap background, localize edits with spatial language, multi-image batch edits up to 20 inputs), the schema, and when to route to GPT Image 2 edit / Flux Kontext / Nano Banana 2 t2i instead. Calls `runcomfy run google/nano-banana-2/edit` through the local RunComfy CLI. Triggers on "nano banana edit", "edit with nano banana", "image edit nano banana", or any explicit ask to edit with this model.

424014 installs

Official URL:Author homepage

What this skill does

Intro in this page language first. The official description stays in its original wording; we do not rewrite SKILL.md.

What it does

Edit images with Google Nano Banana 2 (image-to-image edit endpoint) on RunComfy. Documents Nano Banana Edit's strengths (preserve subject identity, swap background, localize edits with spatial language, multi-image batch edits up to 20 inputs), the schema, and when to route to GPT Image 2 edit / Flux Kontext / Nano Banana 2 t2i instead. Calls `runcomfy run google/nano-banana-2/edit` through the local RunComfy CLI. Triggers on "nano banana edit", "edit with nano banana", "image edit nano banana", or any explicit ask to edit with this model.

When to use it

The official description does not include a separate “Use when”. Per the spec, agents activate this skill when the task matches keywords in that description.

How agents load it

Per Agent Skills progressive disclosure: name and description load at startup (~100 tokens); the full SKILL.md body loads when the skill activates; scripts/, references/, and assets/ load only as needed. This file's sections: Nano Banana Edit — Pro Pack on RunComfy; When to pick this model (vs siblings); Prerequisites; Endpoints + input schema; `google/nano-banana-2/edit`; How to invoke. It includes spec-recommended sections: edge cases.

File analysis

File analysis: instruction-only skill (SKILL.md). The agent loads the full body when activated.

Nano Banana Edit — Pro Pack on RunComfyWhen to pick this model (vs siblings)PrerequisitesEndpoints + input schema`google/nano-banana-2/edit`How to invokePrompting — what actually worksWhere it shinesSample prompts (verified to produce strong results)LimitationsExit codesHow it works

· License:MIT

Source category:skills.sh agent-skill

SKILL.md & Agent activation

Official spec ↗
name
nano-banana-edit
description
Edit images with Google Nano Banana 2 (image-to-image edit endpoint) on RunComfy. Documents Nano Banana Edit's strengths (preserve subject identity, swap background, localize edits with spatial language, multi-image batch edits up to 20 inputs), the schema, and when to route to GPT Image 2 edit / Flux Kontext / Nano Banana 2 t2i instead. Calls `runcomfy run google/nano-banana-2/edit` through the local RunComfy CLI. Triggers on "nano banana edit", "edit with nano banana", "image edit nano banana", or any explicit ask to edit with this model.
License
MIT
  1. DiscoverThe client exposes names and descriptions to the agent.
  2. ActivateYour request or the task context selects the skill and loads its instructions.
  3. Load resourcesReferenced scripts, documentation and assets are used when needed.

Invocation syntax and available tools depend on your Agent client. Client integration guide ↗

Install this skill

Skills CLI ↗

Choose the target agent and installation scope, keep referenced package files, then verify the skill appears in the client's catalog.

Ask your Agent to install

Copy these instructions to a compatible agent and confirm the target directory matches your client.

Install the agent skill "nano-banana-edit" into my project. The full SKILL.md and official description are at https://zicq.com/en/skills/skl-b360346dd4ba71c5-Nano-Banana-Edit.html
Save it as .cursor/skills/nano-banana-edit/SKILL.md or .claude/skills/nano-banana-edit/SKILL.md and keep the frontmatter name and description exactly as-is.

Full package on GitHub ↗

Install from the terminal · Skills CLI

Requires Node.js and npx. First inspect the repository's skill list to confirm the name.

npx skills add 'https://github.com/prime-skills/runcomfy-agent-skills' --list

npx skills add 'https://github.com/prime-skills/runcomfy-agent-skills' --skill 'nano-banana-edit'

The CLI lets you choose the agent interactively. The default scope is the project; use -g for user scope. Confirm package availability with the discovery command, then use npx skills list to inspect installed skills.

Readable layout
--- name: nano-banana-edit displayName: "Nano Banana Edit — Pro Pack on RunComfy" description: > Edit images with Google Nano Banana 2 (image-to-image edit endpoint) on RunComfy. Documents Nano Banana Edit's strengths (preserve subject identity, swap background, localize edits with spatial language, multi-image batch edits up to 20 inputs), the schema, and when to route to GPT Image 2 edit / Flux Kontext / Nano Banana 2 t2i instead. Calls `runcomfy run google/nano-banana-2/edit` through the local RunComfy CLI. Triggers on "nano banana edit", "edit with nano banana", "image edit nano banana", or any explicit ask to edit with this model. homepage: https://www.runcomfy.com license: MIT --- # Nano Banana Edit — Pro Pack on RunComfy [runcomfy.com](https://www.runcomfy.com/?utm_source=skills.sh&utm_medium=skill&utm_campaign=nano-banana-edit) · [Edit endpoint](https://www.runcomfy.com/models/google/nano-banana-2/edit?utm_source=skills.sh&utm_medium=skill&utm_campaign=nano-banana-edit) · [GitHub](https://github.com/agentspace-so/runcomfy-skills/tree/main/nano-banana-edit) Google **Nano Banana 2 Edit** — the image-to-image edit endpoint of the Gemini-family flash-tier image model — hosted on the **RunComfy Model API**. Up to **20 input images per call** for batch edits and multi-reference variation. ```bash npx skills add agentspace-so/runcomfy-skills --skill nano-banana-edit -g ``` ## When to pick this model (vs siblings) | You want | Use | |---|---| | Preserve subject identity, swap background or clothing | **Nano Banana Edit** | | Edit up to 20 images consistently in one batch | **Nano Banana Edit** | | Localize edit to "X only" with spatial language | **Nano Banana Edit** | | Edit multilingual text inside the image (signs, labels) | GPT Image 2 edit | | Single ref + precise local edit ("she's now holding X") | Flux Kontext | | Generate a new image from scratch | Nano Banana 2 t2i (sibling skill) | If the user said "nano banana edit" / "edit with nano banana" explicitly, route here regardless. ## Prerequisites 1. **RunComfy CLI** — `npm i -g @runcomfy/cli` 2. **RunComfy account** — `runcomfy login` opens a browser device-code flow. 3. **CI / containers** — set `RUNCOMFY_TOKEN=` instead of `runcomfy login`. ## Endpoints + input schema ### `google/nano-banana-2/edit` | Field | Type | Required | Default | Notes | |---|---|---|---|---| | `prompt` | string | yes | — | Edit instruction. Lead with preservation, end with the change. | | `image_urls` | array | yes | — | **1–20** publicly-fetchable HTTPS URLs. | | `number_of_images` | int | no | 1 | 1–4 outputs per call. | | `seed` | int | no | — | Reproducibility. | | `aspect_ratio` | enum | no | `auto` | `auto` (follows input) or fixed ratios — lock for batch consistency. | | `resolution` | enum | no | `1K` | `0.5K` / `1K` / `2K` / `4K`. | | `output_format` | enum | no | `png` | `png` / `jpeg` / `webp`. | | `safety_tolerance` | int | no | 4 | 1 (strict) – 6 (permissive). | | `limit_generations` | bool | no | — | If true, restricts each round to one output. | | `enable_web_search` | bool | no | false | Web grounding (extra cost / latency). | ## How to invoke **Single-image background swap, identity preserved:** ```bash runcomfy run google/nano-banana-2/edit \ --input '{ "prompt": "Keep the subject identity, pose, and clothing unchanged. Convert the background into a rainy neon cyberpunk street.", "image_urls": ["https://.../portrait.jpg"] }' \ --output-dir ``` **Batch edit with locked framing:** ```bash runcomfy run google/nano-banana-2/edit \ --input '{ "prompt": "Replace the watermark in the bottom-right with the text \"AURA\" in clean white sans-serif. Keep everything else exactly as in the input.", "image_urls": ["https://.../sku-1.jpg", "https://.../sku-2.jpg", "https://.../sku-3.jpg"], "aspect_ratio": "1:1", "resolution": "1K" }' \ --output-dir ``` **Targeted spatial edit ("left object only"):** ```bash runcomfy run google/nano-banana-2/edit \ --input '{ "prompt": "Remove the leftmost object only. Keep the right two objects, the table, and the lighting unchanged.", "image_urls": ["https://.../still-life.jpg"] }' \ --output-dir ``` ## Prompting — what actually works **Preservation first, change last.** Always lead with `"Keep [identity / pose / clothing / brand / framing] unchanged."` Then state the change in one clean sentence. Models honor what's stated up front; tail-end preservations get ignored. **Localize with spatial language.** "background only", "the left object", "the upper-right corner", "above the headline" — concrete spatial scopes are honored. "make it more X" is vague and drifts. **Batch consistency** — when editing a series, lock `aspect_ratio` and `resolution`. Use the same prompt grammar across the batch so each output reads as a sibling, not a remix. **Iterate small.** If a one-pass edit drifts, split into two: pass 1 changes background only, pass 2 swaps the subject's outfit. Cleaner edits, same total cost (assuming similar resolution). **Multi-image variation** — pass up to 20 inputs to get a coherent batch. Useful for SKU galleries, A/B testing, character sheet variations. **Anti-patterns:** - Long compound instructions ("change A and B and C and D") — drift increases per added scope. - Edit instructions written in passive voice ("the background should be changed") — be imperative. - Missing preservation goals — model will subtly rewrite the face / brand. - Aspect ratios that don't match input — causes crops or stretches. ## Where it shines | Use case | Why Nano Banana Edit | |---|---| | **SKU gallery — same product on different backgrounds** | Batch of 20, identity-preserved, framing locked | | **Influencer / spokesperson background swaps** | Strong identity preservation across edits | | **Localized object removal / addition** | Spatial language honored | | **A/B variants for ad creative** | Seed lock + multiple `number_of_images` | | **Brand-asset relocalization** | Same composition with text / palette swap | ## Sample prompts (verified to produce strong results) **Background swap (page example):** ``` Keep the subject identity unchanged. Convert the background into a rainy neon cyberpunk street. ``` **Targeted text replacement:** ``` Keep the bottle, label, and lighting exactly as in the input. Replace only the brand text on the label from "ALPHA" to "AURA", same font weight, centered, white on black. ``` **Multi-image batch consistency:** ``` For each input image: keep the subject's pose and identity unchanged. Convert the background to a soft warm-grey studio sweep with subtle floor shadow. Center the subject at the same fraction of frame as the input. ``` ## Limitations - **1–20 input images per call** — the first is treated as primary; the rest provide auxiliary cues. - **1–4 outputs per call.** - **Long compound prompts drift** — split into multiple passes. - **Web search adds latency + cost** — only enable on demand. - **For multilingual in-image text edits, GPT Image 2 edit wins.** ## Exit codes | code | meaning | |---|---| | 0 | success | | 64 | bad CLI args | | 65 | bad input JSON / schema mismatch | | 69 | upstream 5xx | | 75 | retryable: timeout / 429 | | 77 | not signed in or token rejected | Full reference: [docs.runcomfy.com/cli/troubleshooting](https://docs.runcomfy.com/cli/troubleshooting?utm_source=skills.sh&utm_medium=skill&utm_campaign=nano-banana-edit). ## How it works The skill invokes `runcomfy run google/nano-banana-2/edit` with a JSON body matching the schema. The CLI POSTs to `https://model-api.runcomfy.net/v1/models/google/nano-banana-2/edit`, polls the request, fetches the result, and downloads any `.runcomfy.net`/`.runcomfy.com` URL into `--output-dir`. `Ctrl-C` cancels the remote request before exit. ## Security & Privacy - **Token storage**: `runcomfy login` writes the API token to `~/.config/runcomfy/token.json` with mode 0600 (owner-only read/write). Set `RUNCOMFY_TOKEN` env var to bypass the file entirely in CI / containers. - **Input boundary**: the user prompt is passed as a JSON string to the CLI via `--input`. The CLI does NOT shell-expand the prompt; it transmits the JSON body directly to the Model API over HTTPS. No shell injection surface from prompt content. - **Third-party content**: image / mask / video URLs you pass are fetched by the RunComfy model server, not by the CLI on your machine. Treat external URLs as untrusted; image-based prompt injection is a known risk for any image-edit / video-edit model. - **Outbound endpoints**: only `model-api.runcomfy.net` (request submission) and `*.runcomfy.net` / `*.runcomfy.com` (download whitelist for generated outputs). No telemetry, no callbacks. - **Generated-file size cap**: the CLI aborts any single download > 2 GiB to prevent disk-fill from a malicious or runaway model output.

Related skills

Documents

Ontology

Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, …

Documents

Nano Pdf

Edit PDFs with natural-language instructions using the nano-pdf CLI.

Documents

Word / DOCX

Create, inspect, and edit Microsoft Word documents and DOCX files with reliable styles, numbering, tracked changes, tables, sections, and co…

Documents

Api Gateway

Call third-party APIs through the Maton gateway, which injects the credential for an app the user has already connected. Use this skill when…