---

=== Required (All Platforms) ===

name: nano-banana description: | Use when users request image generation, AI art creation, image editing with Gemini models, need help crafting prompts, or want brand-styled imagery. Handles both direct generation and interactive prompt design.

=== Claude Code / OpenAI Codex ===

allowed-tools: Bash Write Read AskUserQuestion metadata: short-description: Unified image generation workflow with Gemini/Imagen models version: "0.0.7"

=== GitHub Copilot ===

license: MIT

Nano Banana

Unified image generation workflow using a fixed Python script with JSON configuration. Eliminates AI hallucinations by avoiding dynamic code generation.

Supports two modes:

• Unified Generation: All image requests use generate_images.py with JSON config
• Interactive Prompting: Guide user through prompt design with proven techniques

---

🚨 CRITICAL: Read This First

API Selection Rule

BEFORE writing ANY code, determine which API to use:

Copymodel = os.environ.get("NANO_BANANA_MODEL") or "gemini-3-pro-image-preview"

# Select API based on model name
if "imagen" in model.lower():
    use_imagen_api = True   # → generate_images()
else:
    use_imagen_api = False  # → generate_content()

Two COMPLETELY DIFFERENT APIs

These are NOT interchangeable. Using the wrong API will cause errors.

Example model detection:

Copy# These trigger Imagen API:
"imagen-4.0-generate-001" → generate_images()
"custom-imagen-v2" → generate_images()

# These trigger Gemini API:
"gemini-3-pro-image-preview" → generate_content()
"gemini-2.5-flash-image" → generate_content()
"custom-gemini-image" → generate_content()

❌ DOES NOT EXIST - Never Use These

If you find yourself writing these, STOP - you are using the wrong API:

NANO_BANANA_MODEL: NEVER Override

Rule: If NANO_BANANA_MODEL is set, use it EXACTLY as-is.

❌ WRONG - Do NOT do this:

Copymodel = os.environ.get("NANO_BANANA_MODEL", "gemini-3-pro-image")
if not model.endswith("-preview"):
    model = f"{model}-preview"  # ❌ NEVER modify user's model name

✅ CORRECT:

Copymodel = os.environ.get("NANO_BANANA_MODEL")
if not model:
    # Only choose default when NANO_BANANA_MODEL is NOT set
    model = "gemini-3-pro-image-preview"
# Use model EXACTLY as-is - do NOT add suffixes or change names

Why this matters:

• Custom endpoints have their own model names (e.g., gemini-3-pro-image without -preview)
• User explicitly set the model they want
• DO NOT apply Google's naming conventions to custom endpoints

---

When to Use

• Image generation ("draw", "create", "generate"), slides, presentations
• Image editing with AI
• Prompt help ("help me craft", "improve my prompt")
• Brand styles ("use style trend", "notebooklm style")

Mode selection:

• Interactive Prompting: User asks for prompt help OR prompt too vague (<5 words)
• Unified Generation: User provides detailed prompt (uses generate_images.py)

Style Detection

Detect: style: "trendlife", style: "notebooklm", or natural language ("use trendlife style", "notebooklm style")

Styles:

• TrendLife: Trend Micro's TrendLife product brand (Trend Red #D71920) with automatic logo overlay
• NotebookLM: Clean presentation aesthetic (⚠️ NEVER use "NotebookLM" brand/logo in prompts)

Priority: Inline spec → Ask in Interactive Mode → No style (Direct Mode default)

---

Logo Overlay (TrendLife Style)

TrendLife style includes automatic logo overlay:

When style: "trendlife" is detected:

1. Generate slide image with TrendLife colors (no logo in prompt)
2. Detect layout type from prompt content
3. Apply logo overlay with logo_overlay.overlay_logo()
4. Output final image with logo

Layout Detection Rules

Automatic detection based on keywords:

• "title slide", "cover slide", "opening" → title layout (15% logo, bottom-right)
• "end slide", "closing", "thank you", "conclusion" → end layout (20% logo, center-bottom)
• "divider", "section break" → divider layout (15% logo, bottom-right)
• Slide number 1 (no keywords) → title layout (assumed opener)
• Default → content layout (12% logo, bottom-right)

Manual Logo Overlay Override

Use when you need custom logo positioning:

IMPORTANT: This script must be run with uv run to ensure dependencies are available.

Copy#!/usr/bin/env python3
# /// script
# dependencies = ["pillow"]
# ///
# Run with: uv run your_script.py

# After image generation, before final output
from pathlib import Path
import sys

# Import logo overlay module
sys.path.insert(0, str(Path(__file__).parent))
from logo_overlay import overlay_logo, detect_layout_type

# Detect layout type (or specify manually)
layout_type = detect_layout_type(prompt, slide_number=1)
# Or override: layout_type = 'title'  # 'title', 'content', 'divider', 'end'

# Logo path
logo_path = Path(__file__).parent / 'assets/logos/trendlife-logo.png'

# Apply logo overlay
output_with_logo = output_path.with_stem(output_path.stem + '_with_logo')
overlay_logo(
    background_path=output_path,
    logo_path=logo_path,
    output_path=output_with_logo,
    layout_type=layout_type,
    opacity=1.0  # Optional: 0.0-1.0
)

# Replace original with logo version
output_with_logo.replace(output_path)

Style Trigger Keywords

Explicit: style: "trendlife"

Natural Language:

• "trendlife style"
• "use trendlife"
• "trendlife brand"
• "trendlife presentation"

Quick Reference

API Selection (CRITICAL - Check First)

See CRITICAL section above for complete details.

Unified Generation Workflow

All image generation uses the same fixed Python script with JSON config:

1. Create Config: Write JSON to system temp directory (NOT skill directory)
   • Use Write tool with path: {temp_dir}/nano-banana-config-{timestamp}.json
   • Get temp_dir from user's OS temp location (cross-platform)
2. Execute Script: uv run {base_dir}/generate_images.py --config <temp_config_path>
   • {base_dir} is the skill base directory provided by Claude Code when loading the skill
   • CRITICAL: Use absolute path to script WITHOUT changing directory (no cd command)
   • WRONG: cd {base_dir} && uv run generate_images.py ... ❌
   • CORRECT: uv run {base_dir}/generate_images.py ... ✅
   • This ensures execution cwd remains in user's project directory, so relative paths in config work correctly
3. Track Progress: Monitor progress/results files (for background tasks)
4. Return Paths: Report generated image locations

IMPORTANT:

• Always write config to system temp directory, NEVER to skill base directory
• Always use {base_dir}/generate_images.py for the script path (cross-platform compatible)

Config Requirements:

Minimal Config (recommended):

Copy{
  "slides": [{"number": 1, "prompt": "...", "style": "trendlife"}],
  "output_dir": "./001-feature-name/"  // MUST use NNN-short-name format
}

Full Config (optional fields):

Copy{
  "slides": [{"number": 1, "prompt": "...", "style": "trendlife"}],
  "output_dir": "./001-feature-name/",  // MUST use NNN-short-name format
  "format": "webp",    // Optional: webp (default, RECOMMENDED), png, jpg
  "quality": 90        // Optional: 1-100 (default: 90)
}

Format Selection Guide:

• webp (RECOMMENDED): Default format, automatically uses lossless compression for presentation styles (trendlife, professional, data-viz). Same quality as PNG but 25-35% smaller file size.
• png: Only use if webp compatibility is a concern (rare). Larger file size.
• jpg: For photos only, not suitable for slides/diagrams (lossy compression).

Field Rules:

• ✅ output_dir MUST be relative path with NNN-short-name format: ./001-feature-name/
  • NNN = 3-digit number (001, 002, etc.)
  • short-name = brief descriptive name (lowercase, hyphens)
  • Examples: ./001-ai-safety/, ./002-threat-detection/, ./003-user-onboarding/
• ❌ NO absolute paths (breaks cross-platform)
• ❌ NO plain names without numbers (e.g., ./slides/ is WRONG)
• ❌ NO model field (use NANO_BANANA_MODEL env var)

Output Directory Behavior:

• Relative paths resolve to user's current working directory
• Script is executed with absolute path, but cwd remains in user's directory
• Use sequential numbering for different presentation topics

Example: Config File Creation

Copy# Linux/macOS: Write to /tmp/
Write tool: /tmp/nano-banana-config-1234567890.json

# Windows: Write to %TEMP%
Write tool: C:/Users/<user>/AppData/Local/Temp/nano-banana-config-1234567890.json

Multi-Slide Generation:

• Any slide count → Uses same workflow (generate_images.py)
• 5+ slides → Automatic background execution with progress tracking
• Context efficient → <500 tokens for any slide count

Complete workflow details: See references/batch-generation.md

Interactive Prompting Mode

Interactive Prompting Mode

When to use: User requests prompt help ("help me craft", "improve my prompt") or prompt is too vague (<5 words).

Workflow

1. Gather - Check for reference images, existing prompts, inline style specs (style: "trend")
2. Clarify - Use AskUserQuestion: Output type? Subject? Style preference?
3. Select Technique - Choose from 16+ patterns in references/guide.md
4. Generate Prompt - Apply technique + brand style + aspect ratio
5. Present - Show prompt with explanation and variations
6. Execute - Generate using unified generation workflow (generate_images.py)

Brand Style Integration:

• NotebookLM style (style: "notebooklm"):

  • Apply aesthetic: polished tech infographic, clean slide layout, minimal text
  • ⚠️ NEVER use "NotebookLM" brand/logo/name in prompts (trademark violation)
  • ✅ Use: "clean professional presentation aesthetic", "modern tech infographic style"
  • See references/slide-deck-styles.md for complete specs

• Trend Micro style (style: "trend"):

  • Colors: Trend Red (#d71920), Guardian Red (#6f0000), Grays (#58595b-#e6e7e8)
  • See references/brand-styles.md for complete specs

Complete techniques and examples: See references/guide.md

Debugging

Most Common Errors

Debug Steps

1. Verify API key: echo $GEMINI_API_KEY
2. Test with simple prompt: "A red circle"
3. Check response object: print(response.parts) or print(response.generated_images)
4. Review CRITICAL section if API errors occur

Common Mistakes

References

• Advanced workflows: references/guide.md (thinking, search grounding, 16+ prompting techniques)
• Brand styles: references/brand-styles.md (Trend Micro specs)
• Slide decks: references/slide-deck-styles.md (NotebookLM aesthetic, infographics, data viz)