genimage

name

genimage

description

Generate, edit, or create any image — photos, illustrations, icons, thumbnails, hero images, banners, placeholder visuals, website graphics, social media assets, product shots, logos, diagrams, or any visual content. Use this skill whenever the task involves creating an image, populating a UI with visuals, generating placeholder or mockup images, editing or retouching a photo, applying style transfer, composing multiple images, or producing any graphic asset. Triggers on requests like "generate an image", "create a visual", "make a placeholder", "add a hero image", "design a thumbnail", "edit this photo", "create website graphics", "populate with images", or any task requiring image creation or manipulation.

Nano Banana — Image Generation

Generate and edit images via the Gemini API. If the API key is missing, run /nano-banana:setup.

Workflow

1. Determine the mode from the user's request:

   • Creating a new image from text? → Text-to-image (no --images)
   • Editing/retouching an existing image? → Image editing (--images source.png)
   • Applying one image's style to another? → Style transfer (--images style.png target.png)
   • Combining or referencing multiple images? → Multi-image (--images a.png b.png ..., up to 14)
   • Need 2K or 4K output? → Add --resolution 2K|4K to any mode above

2. Craft the prompt — describe the desired result narratively. See references/prompting-guide.md for domain-specific patterns (website visuals, placeholders, product shots, etc.).

3. Run the script:

python "$CLAUDE_PLUGIN_ROOT/scripts/genimage.py" --prompt "..." [options]

4. Show the result — read the output image and present it to the user.

Flags

Flag	Required	Purpose
--prompt "text"	Yes	Describe the desired image
--output file.png	No	Output path (default: generated_image.png)
--images path [...]	No	Input image(s) — omit for text-to-image
--aspect-ratio RATIO	No	1:1 2:3 3:2 3:4 4:3 4:5 5:4 9:16 16:9 21:9
--resolution RES	No	1K 2K 4K (uppercase K required, triggers Pro model)

Models

• Nano Banana 2 (gemini-3.1-flash-image-preview): Default. Fast, high-quality.
• Nano Banana Pro (gemini-3-pro-image-preview): Auto-selected when --resolution is set. 4K output, advanced reasoning, high-fidelity text rendering.

Common Use Cases → Flags

Use case	Example command
Website hero image	--prompt "..." --aspect-ratio 16:9
Social media post	--prompt "..." --aspect-ratio 1:1
Mobile banner	--prompt "..." --aspect-ratio 9:16
Placeholder / mockup	--prompt "..." --output placeholder.png
Edit existing photo	--prompt "remove the background" --images photo.png
Style transfer	--prompt "Apply watercolor style" --images style.png photo.png
High-res asset	--prompt "..." --resolution 4K

Editing

All editing is text-guided — describe what to change ("replace the sky", "remove the person", "add a sunset") and Gemini identifies and modifies regions automatically. No masks needed.