Nanobanana

---
name: nanobanana
description: "Craft high-precision prompts and edit instructions for Nano Banana image workflows, especially when using the local nanobanana MCP tools for generation, editing, character consistency, or multi-image fusion. Use when the task needs structured prompts, reference-role assignment, layout-heavy image specs, typography-heavy images, iterative edit-first refinement, or reliable model/aspect/output-path choices."
---

# Nanobanana

Use this skill to turn a vague image request into a prompt that Nano Banana can execute reliably, or to refine an existing image/edit request without restarting from scratch.

## Workflow

1. Identify the operation first.

- `generate`: create a new image from text and optional references.
- `edit`: modify an existing image while preserving specified elements.
- `character_consistency`: keep one character stable across scenes.
- `multi_image_fusion`: combine several references into one coherent result.

1. Choose the lowest-complexity prompt shape that fits the ask.

- Use a short natural-language prompt for simple scenes.
- Use a structured block for multi-part layouts, infographics, or scene logic.
- Use JSON-like structure when the user needs many simultaneous constraints or multiple reference roles.

1. Build the prompt in this order.

- Subject: who or what must appear.
- Action/state: what is happening.
- Setting: where it is happening.
- Composition: framing, camera angle, spatial layout.
- Lighting/mood: time of day, light direction, contrast, atmosphere.
- Style/materiality: photoreal, editorial, infographic, matte acrylic, film grain, etc.
- Constraint layer: exact text, counts, positions, identity preservation, what must remain unchanged.

1. Prefer positive, explicit constraints.

- Say what should be present and how it should behave.
- For edits, explicitly state what must remain unchanged.
- For text rendering, quote exact text and specify placement plus typographic character.

1. Use edit-first iteration.

- If the first output is close, preserve the successful parts and request only the delta.
- Example: `Keep composition, subject identity, and wardrobe identical; shift lighting to golden hour and replace background with a foggy bridge.`

## Local MCP Rules

- `mcp__nanobanana__generate_image` is for new images.
- `mcp__nanobanana__edit_image` is for targeted changes to an existing image.
- `mcp__nanobanana__character_consistency` is for repeated scenes with one character reference.
- `mcp__nanobanana__multi_image_fusion` is for combining several references.
- `output_path` must stay inside the tool's allowed repo-local output area. In practice, use a simple filename or relative path; do not pass an absolute path outside `image_out`.
- Every image-generation or image-editing MCP call must explicitly pass
  `model: gemini-3-pro-image-preview`.
- Pass image inputs through `referenceImagePaths` with the smallest complete set of
  references for the operation. Do not throw every available reference into a general
  pool; assign only the location, prop, style, and character anchors that constrain the
  current frame.
- If `gemini-3-pro-image-preview` is unavailable, rejected by the tool, or cannot
  accept the required reference images, character-consistency images, or
  multi-image-fusion inputs for the requested operation, stop the workflow and report
  the blocker. Do not fall back to another image model.

## Model Selection

- Use `gemini-3-pro-image-preview` for all Nano Banana image workflows, including
  generation, editing, character consistency, and multi-image fusion.
- Do not choose a speed, aspect-ratio, or fast-iteration fallback model. If the required
  image operation cannot run on `gemini-3-pro-image-preview`, stop and surface the
  exact limitation.

## Prompting Patterns

- For simple generation, use the formula in [references/frameworks.md](./references/frameworks.md).
- For structured scene blueprints, multi-reference prompts, and edit instructions, use [references/frameworks.md](./references/frameworks.md).
- For reusable prompt skeletons across posters, product shots, infographics, floor plans, storyboards, and character scenes, use [references/examples.md](./references/examples.md).

## Guardrails

- Do not overstuff the prompt with decorative synonyms when concrete constraints will do.
- For exact counts, rows, layouts, labels, or room sizes, state them numerically and spatially.
- For reference images, assign each image a job such as identity, pose, style, lighting, or environment.
- For text-heavy images, keep each required text string short unless the user explicitly needs a dense poster or infographic.
- When an example from the source material is unsafe, irrelevant, or too verbose for direct reuse, extract the pattern and rewrite it into a safe, shorter template rather than copying it.

## Deliverable Style

- If the user asks for an image, provide a prompt plus suggested model, aspect ratio, and any reference-role mapping.
- If the user asks for an edit, provide the preservation constraints first, then the requested changes.
- If the user asks for multiple options, vary composition and lighting before varying everything else.