| created | "2025-12-16T00:00:00.000Z" |
| modified | "2026-05-09T00:00:00.000Z" |
| reviewed | "2026-04-25T00:00:00.000Z" |
| description | Image generation via Gemini 3 Pro Image: aspect ratio, resolution, reference images. Use when creating artwork, product photos, or mockups with AI. |
| allowed-tools | Bash, Read, WebFetch |
| model | sonnet |
| args | <prompt> [--aspect <ratio>] [--resolution <size>] [--reference <path>] |
| disable-model-invocation | true |
| name | generate-image |
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
