image-generation

Image Generation Skill

You have access to Google Gemini image generation via the generate_image MCP tool.

When to Use

Generate images when the user:

• Asks for an image, illustration, or visual asset
• Needs a hero image, placeholder, icon, or background for a project
• Asks to edit, modify, or iterate on an existing image
• Mentions creating visual content of any kind

How to Use

Call the generate_image tool. The behaviour depends on the parameters:

Text-to-Image (no input images)

{
  "prompt": "A modern dashboard UI with dark theme and blue accent colours",
  "aspectRatio": "16:9",
  "resolution": "2K",
  "filename": "dashboard-hero",
  "subfolder": "landing-page"
}

Image Editing (with input images)

{
  "prompt": "Change the background to a sunset over water",
  "images": ["./src/assets/hero.png"],
  "aspectRatio": "16:9"
}

Multi-Turn Refinement

The tool returns a sessionId with every response. Pass it back to continue editing:

{
  "prompt": "Make the colours warmer and add more contrast",
  "sessionId": "session-1711929600000-a1b2c3"
}

This preserves the conversation history so the model remembers what it generated.

Output Organization

• Use filename to give images meaningful names (e.g. hero-banner instead of gemini-1711929600000-a1b2c3)
• Use subfolder to group related assets (e.g. landing-page, blog-posts)
• Duplicate filenames are auto-versioned: hero.png, hero-v2.png, hero-v3.png
• When generating assets for a project, save them directly to the project's asset directory using outputDir

Image Processing (process_image)

Use process_image for local, free operations that don't need AI:

Common Pipelines

Subject on a specific background (canvas approach — recommended): Create a solid colour canvas with process_image, then feed it to generate_image as input. Gemini places the subject with correct lighting and reflections — no chroma key needed.

// Step 1: generate_image with a canvas image as input
{
  "prompt": "Place a yellow rubber duck on this background. Product photography, studio lighting, centered.",
  "images": ["./canvas-white.png"],
  "filename": "duck-on-white"
}

This is better than chroma key for yellow, green, or glass/reflective subjects.