Edit Image

Edit images using Gemini’s native image generation (gemini-2.5-flash-image).

When to Use

Use this skill when the user asks to:

• Edit part of an image (inpainting)
• Extend an image beyond its borders (outpainting)
• Replace objects or regions in an image
• Add elements to an existing image

How It Works

Uses Gemini’s multimodal capabilities to understand and edit images via natural language. The model takes the source image and a text prompt describing the desired edit, then generates a new image with the changes applied.

Semantic masking: Instead of requiring precise pixel masks, describe what to change in your prompt. The model understands context and can target specific regions.

Optional mask images: You can still provide a mask image (white = edit area) as a visual hint, but it’s not required. Descriptive prompts often work better.

Usage

cd ${CLAUDE_PLUGIN_ROOT}/skills/edit-image && bun run scripts/edit.ts <input-image> "edit prompt" [options]

Options

• --mask <path> – Optional mask image (white = edit area, black = keep)
• --mode <inpaint|outpaint> – Edit mode
• --format <png|jpeg|webp> – Output format
• --quality <n> – JPEG quality (1-100)
• --negative <prompt> – What to avoid in the edit
• --count <n> – Number of variations
• --seed <n> – Random seed
• --output <path> – Output path

Examples

# Simple edit with descriptive prompt (no mask needed)
cd ${CLAUDE_PLUGIN_ROOT}/skills/edit-image && bun run scripts/edit.ts photo.jpg "change the background to a beach sunset"

# Edit with mask for precise control
cd ${CLAUDE_PLUGIN_ROOT}/skills/edit-image && bun run scripts/edit.ts photo.jpg "add a sunset sky" --mask sky_mask.png --mode inpaint

# Outpaint to extend image
cd ${CLAUDE_PLUGIN_ROOT}/skills/edit-image && bun run scripts/edit.ts photo.jpg "extend the landscape" --mode outpaint

# Edit with negative prompt
cd ${CLAUDE_PLUGIN_ROOT}/skills/edit-image && bun run scripts/edit.ts portrait.png "fix the teeth to look natural" --negative "gap in teeth, missing teeth"

# Replace object with multiple variations
cd ${CLAUDE_PLUGIN_ROOT}/skills/edit-image && bun run scripts/edit.ts scene.jpg "replace the car with a bicycle" --count 3

Prompt Tips

• Be specific: “Change only the sky to golden hour lighting” works better than “make it look better”
• Describe preservation: The tool automatically adds “keep everything else the same” but you can be more specific
• Use negative prompts: --negative "blurry, distorted" helps avoid unwanted artifacts
• Iterate: Generate a few variations with --count 2 and pick the best one

Model

Uses gemini-2.5-flash-image via the standard Gemini API. No Vertex AI credentials required.