Nano Image Generator Skill

简体中文

A Claude Code skill for generating images using Gemini 3 Pro Preview (Nano Banana Pro).

Features

• Text-to-image generation - Describe what you want, get an image
• Reference image support - Style transfer, character consistency (up to 14 images)
• Multiple aspect ratios - Square, portrait, landscape, cinematic
• Resolution options - 1K, 2K, 4K output

Differences from livelabs-ventures/nano-skills

Feature	Original	This Version
Reference images	❌ Not supported	✅ Up to 14 images
API key config	Environment variable	Direct code edit

Setup

1. Get Gemini API Key

Visit: https://aistudio.google.com/apikey

2. Configure API Key

Edit scripts/generate_image.py, find the get_api_key() function (around line 37):

def get_api_key():
    """
    Get API key.

    ⚠️ SETUP REQUIRED: Replace the placeholder below with your Gemini API key.

    Get your API key from: https://aistudio.google.com/apikey
    """
    return "YOUR_GEMINI_API_KEY_HERE"  # <-- Replace this with your API key

Replace YOUR_GEMINI_API_KEY_HERE with your actual API key:

    return "AIzaSy..."  # Your actual key

Installation

From Local Path

git clone https://github.com/YOUR_USERNAME/nano-image-generator-skill.git

Add to your ~/.claude/settings.json:

{
  "skills": [
    "/path/to/nano-image-generator-skill"
  ]
}

From GitHub

claude skill add github:YOUR_USERNAME/nano-image-generator-skill

Plugin Structure

nano-image-generator-skill/
├── SKILL.md                    # Skill definition for Claude Code
├── README.md                   # This file
├── README_CN.md                # Chinese documentation
└── scripts/
    └── generate_image.py       # Image generation script (edit API key here)

Usage

Once installed, Claude Code will automatically use this skill when you ask to:

• "Generate an image of..."
• "Create an icon for..."
• "Design a logo..."
• "Make a banner..."
• "Same style as this image..."

Direct Script Usage

Basic

python scripts/generate_image.py "A cute robot mascot" --output ./robot.png

With Aspect Ratio

python scripts/generate_image.py "Website banner" --aspect 16:9 --output ./banner.png

With Reference Image

python scripts/generate_image.py "Same character in a forest" --ref ./character.png --output ./forest.png

Multiple References

python scripts/generate_image.py "Combine styles" --ref ./img1.png --ref ./img2.png --output ./combined.png

Options

Option	Values	Default	Description
--aspect, -a	1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9	1:1	Aspect ratio
--size, -s	1K, 2K, 4K	2K	Resolution
--ref, -r	Image path	-	Reference image (repeatable, max 14)

License

MIT