generate-image
The base image skill. Use it standalone for hero shots, character
reference sheets, thumbnails, or product photos — or as a building
block (start frame for /generate-video, slide for
/generate-carousel). The skill's job is to turn a rough idea into a
finished PNG, refining the prompt and picking the right model along
the way.
Providers
- Wavespeed — pull
https://wavespeed.ai/docs for the current API surface; model-specific endpoints under https://wavespeed.ai/docs/docs-api/... (e.g. bytedance/bytedance-nano-banana-2, openai/gpt-image-2)
Pick the model
| Model |
Best for |
Trade-off |
| Nano Banana 2 |
Hyperrealistic product photos, characters, lifestyle scenes. Strong identity lock from reference image. |
Weak at typography — keep on-image text minimal (logos, short wordmarks only). |
| GPT-Image 2 |
Reliable in-image typography. Carousels, slides, infographics, posters, thumbnails with words. |
Less photorealistic — visible "AI illustration" aesthetic on faces and skin. |
Rule of thumb: if the image needs words baked in, use GPT-Image 2.
Otherwise Nano Banana 2.
Steps
- Capture the idea. Ask the user: what's the subject, what's the
scene/setting, what's the angle/framing, what's the deliverable
(e-commerce listing, video starting frame, slide), and what's the
target aspect ratio.
- Refine the prompt. Rewrite the idea into a model-appropriate
structured prompt:
- Nano Banana 2 →
Hyperrealistic photo: [subject] in [setting], [framing — e.g. 3/4 profile], [lighting — e.g. softbox above left], [aspect]. 3–5 specific material/shape callouts; more and
the model averages.
- GPT-Image 2 →
[Composition]: [subject] with text "[exact text]", [layout], [style]. Quote the exact text to bake in.
Read the refined prompt back to the user and iterate before any
provider call.
- Pick the model from the table above.
- Set the params. Size / aspect ratio (
1024*1024 square,
1024*1792 9:16, 1792*1024 16:9), number of variations.
- Generate. Call the chosen Wavespeed endpoint, download the
PNG(s) to
CWD/generate-image-<timestamp>/.
- Show the user the result and offer to regenerate or adjust.
Save the final prompt alongside the PNG.
Input
- Idea (subject, scene, framing)
- (optional) Reference image for identity lock (Nano Banana 2)
- Aspect ratio / size
- (optional) Exact in-image text (GPT-Image 2)
Output
- PNG(s) at
CWD/generate-image-<timestamp>/
- Wavespeed-hosted URL(s) printed for reuse (e.g. as
image input to
/generate-video)
- The final prompt saved alongside the PNG for iteration
Common failure modes
- Stylized / cartoony Nano Banana output — prompt didn't anchor
the model. Add "hyperrealistic" + "photograph".
- Garbled GPT-Image 2 typography — the text wasn't quoted, or it
was too long. Quote exact characters; cap at ~6 words per line.
- Background bleeding into product — add "cutout on seamless
white background, no reflections" for Nano Banana product shots.
1---2name: generate-image3description: Generate one AI image from an idea. Walks the user from rough concept → refined prompt → model pick (Nano Banana 2 or GPT-Image 2) → final PNG via Wavespeed.4---56# generate-image78The base image skill. Use it standalone for hero shots, character9reference sheets, thumbnails, or product photos — or as a building10block (start frame for `/generate-video`, slide for11`/generate-carousel`). The skill's job is to turn a rough idea into a12finished PNG, refining the prompt and picking the right model along13the way.1415## Providers1617- **Wavespeed** — pull `https://wavespeed.ai/docs` for the current API surface; model-specific endpoints under `https://wavespeed.ai/docs/docs-api/...` (e.g. `bytedance/bytedance-nano-banana-2`, `openai/gpt-image-2`)1819## Pick the model2021| Model | Best for | Trade-off |22|---|---|---|23| **Nano Banana 2** | Hyperrealistic product photos, characters, lifestyle scenes. Strong identity lock from reference image. | Weak at typography — keep on-image text minimal (logos, short wordmarks only). |24| **GPT-Image 2** | Reliable in-image typography. Carousels, slides, infographics, posters, thumbnails with words. | Less photorealistic — visible "AI illustration" aesthetic on faces and skin. |2526**Rule of thumb:** if the image needs words baked in, use GPT-Image 2.27Otherwise Nano Banana 2.2829## Steps30311. **Capture the idea.** Ask the user: what's the subject, what's the32 scene/setting, what's the angle/framing, what's the deliverable33 (e-commerce listing, video starting frame, slide), and what's the34 target aspect ratio.352. **Refine the prompt.** Rewrite the idea into a model-appropriate36 structured prompt:37 - **Nano Banana 2** → `Hyperrealistic photo: [subject] in [setting],38 [framing — e.g. 3/4 profile], [lighting — e.g. softbox above39 left], [aspect].` 3–5 specific material/shape callouts; more and40 the model averages.41 - **GPT-Image 2** → `[Composition]: [subject] with text "[exact42 text]", [layout], [style].` Quote the exact text to bake in.43 Read the refined prompt back to the user and iterate before any44 provider call.453. **Pick the model** from the table above.464. **Set the params.** Size / aspect ratio (`1024*1024` square,47 `1024*1792` 9:16, `1792*1024` 16:9), number of variations.485. **Generate.** Call the chosen Wavespeed endpoint, download the49 PNG(s) to `CWD/generate-image-<timestamp>/`.506. **Show the user the result** and offer to regenerate or adjust.51 Save the final prompt alongside the PNG.5253## Input5455- Idea (subject, scene, framing)56- (optional) Reference image for identity lock (Nano Banana 2)57- Aspect ratio / size58- (optional) Exact in-image text (GPT-Image 2)5960## Output6162- PNG(s) at `CWD/generate-image-<timestamp>/`63- Wavespeed-hosted URL(s) printed for reuse (e.g. as `image` input to64 `/generate-video`)65- The final prompt saved alongside the PNG for iteration6667## Common failure modes6869- **Stylized / cartoony Nano Banana output** — prompt didn't anchor70 the model. Add "hyperrealistic" + "photograph".71- **Garbled GPT-Image 2 typography** — the text wasn't quoted, or it72 was too long. Quote exact characters; cap at ~6 words per line.73- **Background bleeding into product** — add "cutout on seamless74 white background, no reflections" for Nano Banana product shots.