Claude Code Plugins

Community-maintained marketplace

Feedback

gemini-imagegen

@fltman/claude-code-imagegen-skill
1
29

Generate AI images using Google Gemini via OpenRouter. Use when the user wants to create images, generate pictures, make AI art, edit images, or transform photos. Supports both text-to-image and image-to-image generation.

Install Skill

Shared

Installs to .agents/skills, used by Codex, Amp, Warp, Cursor, OpenCode, and more.

CodexAmp
WarpCursorOpenCode
ClineGemini CLI
GitHub Copilot
Personal

Available across projects.

$npx skills-installer add @fltman/claude-code-imagegen-skill/gemini-imagegen --client shared
Project

Writes to .agents/skills.

$npx skills-installer add @fltman/claude-code-imagegen-skill/gemini-imagegen -p --client shared
Note: Review the skill instructions before using it.

SKILL.md

name gemini-imagegen
description Generate AI images using Google Gemini via OpenRouter. Use when the user wants to create images, generate pictures, make AI art, edit images, or transform photos. Supports both text-to-image and image-to-image generation.

Gemini Image Generation

Generate high-quality AI images using Google's Gemini model via OpenRouter API.

Capabilities

  • Text-to-image: Create images from text descriptions
  • Image-to-image: Transform existing images based on prompts (style transfer, editing, variations)

Requirements

Before using this skill, ensure:

  1. Python packages are installed:

    pip install openai python-dotenv

  2. API key is set:

    export OPENROUTER_API_KEY="your-openrouter-api-key"

    Get your key at: https://openrouter.ai/keys

Usage

Text-to-Image

Generate an image from a text description:

python scripts/generate_image.py --prompt "A serene Japanese garden with cherry blossoms" --output garden.png

Image-to-Image

Transform an existing image:

python scripts/generate_image.py --input photo.jpg --prompt "Transform into a watercolor painting style" --output watercolor.png

Script Arguments

Argument Short Required Description
--prompt -p Yes Text description of the desired image
--output -o No Output file path (default: generated_image.png)
--input -i No Input image for image-to-image mode
--model -m No Model ID (default: google/gemini-3-pro-image-preview)

Prompt Tips

For best results:

  1. Be specific: Include details about style, lighting, composition, and mood
  2. Reference art styles: "in the style of impressionism", "photorealistic", "anime style"
  3. Describe lighting: "soft morning light", "dramatic shadows", "golden hour"
  4. Include atmosphere: "mysterious", "cheerful", "melancholic"

Example Prompts

Portrait:

A portrait of an elderly fisherman with weathered skin and kind eyes, 
wearing a knit cap, soft natural lighting, shallow depth of field, 
photorealistic style

Landscape:

A misty mountain valley at dawn, pine forests in the foreground, 
snow-capped peaks in the distance, rays of sunlight breaking through 
clouds, epic cinematic composition

Abstract:

Abstract fluid art with deep ocean blues and metallic gold, 
swirling patterns resembling galaxies, high contrast, 
luxurious and elegant mood

Workflow

  1. Understand what the user wants to create
  2. Craft a detailed, descriptive prompt
  3. Run the generation script
  4. If the user provides an image, use image-to-image mode
  5. Present the generated image to the user
  6. Offer to iterate or adjust based on feedback

Troubleshooting

"OPENROUTER_API_KEY not set"

  • Set the environment variable: export OPENROUTER_API_KEY="your-key"

"openai package not installed"

  • Install it: pip install openai

"No images found in response"

  • The model may have returned text instead of an image
  • Try rephrasing the prompt to be more visual/descriptive
  • Check if your API key has credits available

Output

The script will:

  1. Print progress messages
  2. Save the image to the specified output path
  3. Print "SUCCESS" with the file path on success
  4. Return exit code 0 on success, 1 on failure