# Image Generation

> Generate images from text descriptions using AI. Use when the user asks to create, generate, draw, or design an image, illustration, icon, or any visual content.

- Skill: `ionclaw-org/image-generation` (Agent Skill)
- Install (CLI): `npx skillmds@latest add ionclaw-org/image-generation`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ionclaw-org/image-generation/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Design & Media
- Author: ionclaw-org (https://skillmd.com/u/ionclaw-org)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/ionclaw-org/image-generation

---


# Image Generation

Generate images using the `generate_image` tool.

## Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `prompt` | string | yes | Detailed description of the image |
| `filename` | string | yes | Output filename (e.g. `poster.png`) |
| `aspect_ratio` | string | no | `1:1`, `16:9`, `9:16`, `4:3`, `3:4`, `3:2`, `2:3`, `4:5`, `5:4`, `21:9` |
| `size` | string | no | `1K` (default), `2K`, `4K` |
| `reference_images` | array | no | Storage paths to reference images |
| `style` | string | no | Style hint (e.g. `photorealistic`, `illustration`) |
| `negative_prompt` | string | no | What to avoid (e.g. `blurry, watermark`) |
| `google_search` | boolean | no | Enable real-time data grounding |

## Prompt Structure

Build prompts with these 5 components:

1. **Style/medium** — photograph, illustration, watercolor, digital art, vector, 3D render
2. **Subject** — who or what, with specific details (pose, clothing, expression, material)
3. **Setting** — location, time of day, atmosphere, weather
4. **Action** — what is happening in the scene
5. **Composition** — camera angle, framing (close-up, wide shot, bird's eye, low angle)

Example: "Cinematic photograph of a futuristic city skyline at golden hour, with flying vehicles crossing between skyscrapers, shot from a rooftop balcony with shallow depth of field, warm amber tones"

## Aspect Ratio Guide

Choose based on the intended use:

- `1:1` — social media posts (Instagram feed, profile pictures)
- `16:9` — banners, landscape, YouTube thumbnails, presentations
- `9:16` — stories, reels, vertical mobile content
- `4:3` — classic photo, presentations
- `3:2` — standard photography
- `4:5` — Instagram portrait posts
- `21:9` — ultrawide cinematic banners

## Reference Images

Reference images provide visual context. The model sees them BEFORE the text prompt.

**For logos and brand assets:**
- Add the logo path to `reference_images`
- In the prompt, be explicit: "Place the provided logo at the bottom center of the image. Do not modify the logo's shape, colors, or proportions — use it exactly as provided, only resize it to fit the composition"
- Never describe what the logo looks like — just describe where and how to use it

**For style references:**
- Add the style image to `reference_images`
- In the prompt: "Generate in the same visual style as the provided reference image"

**For editing existing images:**
- Add the image to `reference_images`
- Describe the desired changes: "Change the background to a sunset beach scene while keeping the subject unchanged"

## Text in Images

- Enclose exact text in quotes: `Write the text "SALE 50% OFF"`
- Describe typography explicitly: "bold white sans-serif font with a subtle drop shadow"
- Specify placement: "centered at the top of the image"
- Keep text minimal for social media — one headline maximum to avoid clutter

## Google Search Grounding

Set `google_search: true` when the image needs real-time or factual data:
- Stock prices and financial charts
- Weather forecasts
- Current events and news topics
- Sports scores and standings
- Real product data

Example: "Visualize the Bitcoin price trend over the last 7 days as an infographic"

## Quality Tips

- **Be descriptive, not repetitive.** Don't use "4K, masterpiece, trending on artstation" — the model understands natural language. Describe the scene vividly instead.
- **Use photographic language** for realistic images: camera model, focal length (85mm f/1.4), lighting setup (soft key light with rim light), film stock (Kodak Portra 400)
- **Be specific about colors and materials:** "matte black aluminum with brushed gold accents" instead of just "dark with gold"
- **Resolution matters:** Use `size: "2K"` for social media, `size: "4K"` for print-quality assets
- **Composition keywords:** rule of thirds, symmetrical, leading lines, negative space, flat lay, isometric

## What NOT to Do

- Don't describe reference images — just describe how to USE them
- Don't add quality spam keywords — focus on scene description
- Don't leave aspect ratio unset for social media — always pick the right ratio
- Don't put too much text in the prompt for text-in-image — keep it to one headline
- Don't forget to use `google_search` when the image needs current real-world data

## After Generation

Always share the saved file URL with the user so they can preview the result.