generate-image
Generate or edit images using AI models (FLUX, Gemini). Use for general-purpose image generation including photos, illustrations, artwork, visual assets, concept art, and any image that isn't a technical diagram or schematic. For flowcharts, circuits, pathways, and technical diagrams, use the scient
By davila7 · 1,340 installs
npx skills add davila7/claude-code-templates --skill generate-image
Source repository · Upstream listing
Generate Image
Generate and edit high quality images using OpenRouter's image generation models including FLUX.2 Pro and Gemini 3 Pro.
When to Use This Skill
Use generate image for:
Photos and photorealistic images
Artistic illustrations and artwork
Concept art and visual concepts
Visual assets for presentations or documents
Image editing and modifications
Any general purpose image generation needs
Use scientific schematics instead for:
Flowcharts and process diagrams
Circuit diagrams and electrical schematics
Biological pathways and signaling cascades
System architecture diagrams
CONSORT diagrams and methodology flowcharts
Any technical/schematic diagrams
Quick Start
Use the scripts/generate image.py script to generate or edit images:
This generates/edits an image and saves it as generated image.png in the current directory.
API Key Setup
CRITICAL : The script requires an OpenRouter API key. Before running, check if the user has configured their API key:
1. Look for a .env file in the project directory or parent directories
2. Check for OPENROUTER API KEY=<key in the .env file
3. If not found, inform the user they need to:
Create a .env file with OPENROUTER API KEY=your api key here
Or set the environment variable: export OPENROUTER API KEY=your api key here
Get an API key from: https://openrouter.ai/keys
The script will automatically detect the .env file and provide clear error messages if the API key is missing.
Model Selection
Default model : google/gemini 3 pro image preview (high quality, recommended)
Available models for generation and editing :
google/gemini 3 pro image preview High quality, supports generation + editing
black forest labs/flux.2 pro Fast, high quality, supports generation + editing
Generation only :
black forest labs/flux.2 flex Fast and cheap, but not as high quality as pro
Select based on:
Quality : Use gemini 3 pro or flux.2 pro
Editing : Use gemini 3 pro or flux.2 pro (both support image editing)
Cost : Use flux.2 flex for generation only
Common Usage Patterns
Basic generation
Specify model
Custom output path
Edit an existing image
Edit with a specific model
Edit with custom output
Multiple images
Run the script multiple times with different prompts or output paths:
Script Parameters
prompt (required): Text description of the image to generate, or editing instructions
input or i : Input image path for editing (enables edit mode)
model or m : OpenRouter model ID (default: google/gemini 3 pro image preview)
output or o : Output file path (default: generated image.png)
api key : OpenRouter API key (overrides .env file)
Example Use Cases
For Scientific Documents
For Presentations and Posters
For General Visual Content
Error Handling
The script provides clear error messages for:
Missing API key (with setup instructions)
API errors (with status codes)
Unexpected response formats
Missing dependencies (requests library)
If the script fails, read the error message and address the issue before retrying.
Notes
Images are returned as base64 encoded data URLs and automatically saved as PNG files
The script supports both images and content response formats from different OpenRouter models
Generation time varies by model (typically 5 30 seconds)
For image editing, the input image is encoded as base64 and sent to the model
Supported input image formats: PNG, JPEG, GIF, WebP
Check OpenRouter pricing for cost information: https://openrouter.ai/models
Image Editing Tips
Be specific about what changes you want (e.g., "change the sky to sunset colors" vs "edit the sky")
Reference specific elements in the image when possible
For best results, use clear and detailed editing instructions
Both Gemini 3 Pro and FLUX.2 Pro support image editing through OpenRouter
Integration with Other Skills
scientific schematics : Use for technical diagrams, flowcharts, circuits, pathways
generate image : Use for photos, illustrations, artwork, visual concepts
scientific slides : Combine with generate image for visually rich presentations
latex posters : Use generate image for poster visuals and hero images