Generate images using Google's Nano Banana Pro (Gemini 3 Pro Image) model.
When to Use This Skill
| Use this skill when... |
Use imagemagick-conversion instead when... |
| Producing a brand-new image from a text prompt |
Converting, resizing, or compressing an existing image |
| Generating cinematic, product, or portrait artwork |
Building thumbnails or batch-processing many files |
| Mixing up to five reference images into a new render |
Applying deterministic transforms (rotate, crop, format) |
| Use this skill when... |
Use mermaid-diagrams or d2-diagrams instead when... |
| The output is a photographic or illustrative image |
The output is a flowchart, sequence, or architecture diagram |
| Quality settings (1K/2K/4K) and aspect ratio matter |
Diagram-as-code rendering would be more maintainable |
Arguments
- {{arg:1}} (required): Image description
- --aspect: Aspect ratio (
1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9) - default: 16:9
- --resolution: Image resolution (
1K, 2K, 4K) - default: 2K
- --reference: Path to reference image (repeatable, max 5)
- --output: Custom output path
Environment Requirements
Verify API key is set:
echo "API Key: ${GOOGLE_API_KEY:+SET}${GEMINI_API_KEY:+SET}"
If not set, get one from: https://aistudio.google.com/apikey
Usage Examples
/generate-image "A beautiful mountain landscape at sunset"
/generate-image "Product photo on white background" --aspect 1:1 --resolution 4K
/generate-image "Portrait photo" --aspect 3:4
/generate-image "Cinematic scene" --aspect 21:9
/generate-image "Similar style" --reference existing_image.png
Task Workflow
Parse arguments:
- Extract prompt from {{arg:1}}
- Identify aspect ratio, resolution, and reference images
Build command:
uv run python .claude/scripts/nano_banana_pro.py \
"{{arg:1}}" \
--aspect {{aspect|default:"16:9"}} \
--resolution {{resolution|default:"2K"}} \
{{reference_flags}}
Execute generation:
uv run python .claude/scripts/nano_banana_pro.py "PROMPT" --aspect RATIO --resolution SIZE
Report results:
- Show path to generated image
- Note any reference images used
- Offer next steps (regenerate, different aspect, etc.)
Output
Default output: ./generated/image_YYYYMMDD_HHMMSS.png
Custom output with --output:
/generate-image "Scene" --output custom_name.png
Reference Images
Reference images help maintain consistency:
- Use existing images as style references
- Keep subjects consistent across generations
- Match artistic styles
When using references, describe the relationship:
- "Similar style to the reference"
- "This person in a different setting"
- "Same product, different angle"
Maximum 5 reference images per generation.
Aspect Ratio Quick Reference
| Use Case |
Ratio |
| Square/Instagram |
1:1 |
| Portrait |
3:4, 9:16 |
| Landscape |
16:9 |
| Ultrawide |
21:9 |
| Photo |
3:2, 4:3 |
Resolution Quick Reference
| Use Case |
Resolution |
| Preview |
1K |
| Standard |
2K |
| High quality |
4K |
Error Handling
- No API key: Set
GOOGLE_API_KEY or GEMINI_API_KEY
- Generation failed: Simplify prompt or reduce references
- Rate limited: Wait and retry
1---2name: generate-image3description: Image generation via Gemini 3 Pro Image: aspect ratio, resolution, reference images. Use when creating artwork, product photos, or mockups with AI.4---5
6Generate images using Google's Nano Banana Pro (Gemini 3 Pro Image) model.
7
8## When to Use This Skill
9
10| Use this skill when... | Use imagemagick-conversion instead when... |
11|---|---|
12| Producing a brand-new image from a text prompt | Converting, resizing, or compressing an existing image |
13| Generating cinematic, product, or portrait artwork | Building thumbnails or batch-processing many files |
14| Mixing up to five reference images into a new render | Applying deterministic transforms (rotate, crop, format) |
15
16| Use this skill when... | Use mermaid-diagrams or d2-diagrams instead when... |
17|---|---|
18| The output is a photographic or illustrative image | The output is a flowchart, sequence, or architecture diagram |
19| Quality settings (1K/2K/4K) and aspect ratio matter | Diagram-as-code rendering would be more maintainable |
20
21## Arguments
22
23- **{{arg:1}}** (required): Image description
24- **--aspect**: Aspect ratio (`1:1`, `2:3`, `3:2`, `3:4`, `4:3`, `4:5`, `5:4`, `9:16`, `16:9`, `21:9`) - default: `16:9`
25- **--resolution**: Image resolution (`1K`, `2K`, `4K`) - default: `2K`
26- **--reference**: Path to reference image (repeatable, max 5)
27- **--output**: Custom output path
28
29## Environment Requirements
30
31Verify API key is set:
32```bash
33echo "API Key: ${GOOGLE_API_KEY:+SET}${GEMINI_API_KEY:+SET}"
34```
35
36If not set, get one from: https://aistudio.google.com/apikey
37
38## Usage Examples
39
40```
41/generate-image "A beautiful mountain landscape at sunset"
42/generate-image "Product photo on white background" --aspect 1:1 --resolution 4K
43/generate-image "Portrait photo" --aspect 3:4
44/generate-image "Cinematic scene" --aspect 21:9
45/generate-image "Similar style" --reference existing_image.png
46```
47
48## Task Workflow
49
501. **Parse arguments**:
51 - Extract prompt from {{arg:1}}
52 - Identify aspect ratio, resolution, and reference images
53
542. **Build command**:
55 ```bash
56 uv run python .claude/scripts/nano_banana_pro.py \
57 "{{arg:1}}" \
58 --aspect {{aspect|default:"16:9"}} \
59 --resolution {{resolution|default:"2K"}} \
60 {{reference_flags}}
61 ```
62
633. **Execute generation**:
64 ```bash
65 uv run python .claude/scripts/nano_banana_pro.py "PROMPT" --aspect RATIO --resolution SIZE
66 ```
67
684. **Report results**:
69 - Show path to generated image
70 - Note any reference images used
71 - Offer next steps (regenerate, different aspect, etc.)
72
73## Output
74
75Default output: `./generated/image_YYYYMMDD_HHMMSS.png`
76
77Custom output with `--output`:
78```
79/generate-image "Scene" --output custom_name.png
80```
81
82## Reference Images
83
84Reference images help maintain consistency:
85- Use existing images as style references
86- Keep subjects consistent across generations
87- Match artistic styles
88
89When using references, describe the relationship:
90- "Similar style to the reference"
91- "This person in a different setting"
92- "Same product, different angle"
93
94Maximum 5 reference images per generation.
95
96## Aspect Ratio Quick Reference
97
98| Use Case | Ratio |
99|----------|-------|
100| Square/Instagram | 1:1 |
101| Portrait | 3:4, 9:16 |
102| Landscape | 16:9 |
103| Ultrawide | 21:9 |
104| Photo | 3:2, 4:3 |
105
106## Resolution Quick Reference
107
108| Use Case | Resolution |
109|----------|------------|
110| Preview | 1K |
111| Standard | 2K |
112| High quality | 4K |
113
114## Error Handling
115
116- **No API key**: Set `GOOGLE_API_KEY` or `GEMINI_API_KEY`
117- **Generation failed**: Simplify prompt or reduce references
118- **Rate limited**: Wait and retry
laurigates