SKILL.md
Gemini Image Generation
Generate images using Google's Gemini and Imagen models.
Prerequisites
The user must have:
- A Google API key with Gemini access set as
GEMINIAPIKEYenvironment variable - Python packages:
pip install google-genai pillow
Available Models
| Model | Best For | Notes |
|---|---|---|
gemini-2.5-flash-image |
Fast, high-volume generation | Speed optimized |
gemini-3-pro-image-preview |
Professional assets, complex prompts | Best quality, supports 4K |
imagen-4.0-generate-001 |
Standard image generation | Good balance |
imagen-4.0-fast-generate-001 |
Quick iterations | Fastest |
imagen-4.0-ultra-generate-001 |
Highest quality | Supports 2K |
Generating Images
Use the script at ~/.claude/skills/gemini-image/scripts/generate.py:
python ~/.claude/skills/gemini-image/scripts/generate.py \
--prompt "A serene mountain landscape at sunset" \
--output ~/Pictures/mountain.png \
--model gemini-2.5-flash-image
Script Arguments
| Argument | Required | Default | Description |
|---|---|---|---|
--prompt |
Yes | - | Text description of the image |
--output |
No | ./generated_image.png |
Output file path |
--model |
No | gemini-2.5-flash-image |
Model to use |
--aspect-ratio |
No | 1:1 |
Aspect ratio (e.g., 16:9, 9:16, 4:3) |
--size |
No | 1K |
Image size (1K, 2K, or 4K for pro model) |
--count |
No | 1 |
Number of images (1-4, Imagen models only) |
Aspect Ratio Options
1:1- Square (default)16:9- Widescreen landscape9:16- Portrait/mobile4:3- Standard landscape3:4- Standard portrait3:2,2:3- Photo aspect ratios
Usage Workflow
- Ask the user what they want to generate
- Craft a detailed prompt (more detail = better results)
- Choose appropriate model and settings
- Run the generation script
- Show the user where the image was saved
- Offer to regenerate with different settings if needed
Prompt Tips
- Be specific and descriptive
- Include style keywords: "photorealistic", "watercolor", "digital art", "3D render"
- Mention lighting: "golden hour", "studio lighting", "dramatic shadows"
- Specify perspective: "aerial view", "close-up", "wide angle"
- Add mood: "serene", "energetic", "mysterious"
Example Prompts
Product shot:
Professional product photography of a sleek smartphone on a marble surface,
soft studio lighting, clean white background, 8K detail
Artwork:
Digital painting of a cyberpunk city at night, neon lights reflecting on
wet streets, flying cars, towering skyscrapers, cinematic composition
Portrait:
Professional headshot of a business executive, neutral background,
soft lighting, confident expression, high resolution
Troubleshooting
- API key error: Ensure
GEMINIAPIKEYis set in your environment - Package not found: Run
pip install google-genai pillow - Rate limit: Wait a few seconds and retry, or use a different model
- Content blocked: Rephrase the prompt to avoid restricted content