generate-image
Generates images using Google Gemini 3 Pro API. Use when asked to create, generate, or design images for slides, presentations, or visual content.
📖 中文导读:Generates images using Google Gemini 3 Pro API. Use when asked to create, generate, or design images for slides, presentations, or visual content. 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: generate-image description: Generates images using Google Gemini 3 Pro API. Use when asked to create, generate, or design images for slides, presentations, or visual content. allowed-tools: Bash(bun:*), Read, Write
Image Generation with Gemini 3 Pro
Generate images for slides and presentations using Google's Gemini 3 Pro image generation API.
Prerequisites
Ensure .env.local exists with your Gemini API key:
GEMINI_API_KEY=your-api-key-here
Usage
Run the generation script:
bun --env-file=.env.local .claude/skills/generate-image/scripts/generate.ts --prompt "your image description" --ratio "16:9" --output "output.png"
Parameters
| Parameter | Required | Default | Description |
|---|---|---|---|
--prompt |
Yes | - | Image description |
--ratio |
No | 16:9 | Aspect ratio: 16:9, 4:3, 1:1, 4:5 |
--output |
No | Auto-generated | Output filename |
Examples
# Widescreen slide background
bun --env-file=.env.local .claude/skills/generate-image/scripts/generate.ts \
--prompt "Abstract dark terminal with glowing code, cyberpunk aesthetic" \
--ratio "16:9"
# Square icon
bun --env-file=.env.local .claude/skills/generate-image/scripts/generate.ts \
--prompt "Minimalist code icon, orange and green on dark background" \
--ratio "1:1" \
--output "code-icon.png"
Output
Images are saved to public/ with auto-generated timestamps if no filename specified.
Prompts are automatically logged to src/prompts/ as JSON files containing:
filename: Output image filenameprompt: The prompt used to generate the imageratio: Aspect ratio usedtimestamp: Generation timestamp (ISO format)model: Gemini model used
This allows you to reference and regenerate images later using the same prompts.
Troubleshooting
- API key not found: Ensure
.env.localexists withGEMINI_API_KEY - Generation failed: Check API key validity and quota
- Model error: The script uses
gemini-3-pro-image-previewmodel