How do I install the Generate Image skill?

Run npx skillmds@latest add cluesmith/generate-image in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Generate Image safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Generate Image?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Generate Image free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Generate Image?

cluesmith (@cluesmith) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Generate Image by cluesmith — Agent Skill

Name: Generate Image
Author: cluesmith

Generate Image

AI image generation via Gemini with optional async providers. Use when the user wants to generate, create, or make an image, or when you need to create visual assets like logos, diagrams, or illustrations. Requires the API key for the selected provider.

cluesmith bda158c 2.9 KB Updated Sep 17, 2026

File contents

generate-image - AI Image Generation

Uses Google Gemini to generate images from text prompts.

Synopsis

codev generate-image "<prompt>" [options]

Note: this is a codev subcommand, not standalone.

All flags

-o, --output <file>        Output file path (default: output.png)
-r, --resolution <res>     Resolution: 1K, 2K, 4K (default: 1K)
-a, --aspect <ratio>       Aspect ratio (default: 1:1)
--ref <image>              Reference image (repeatable, max 14)
-p, --provider <name>      Provider name (default: gemini)

Aspect ratios

1:1 | 16:9 | 9:16 | 3:4 | 4:3 | 3:2 | 2:3

Examples

codev generate-image "A sunset over mountains"
codev generate-image "A futuristic city" -r 4K -a 16:9 -o city.png
codev generate-image "Same style but with cats" --ref style.png --ref layout.png
codev generate-image prompt.txt -o result.png    # Prompt from .txt file

Notes

Prompt must be quoted if it contains spaces
Prompt can be a .txt file path (auto-detected by extension)
Reference images must exist on disk
Requires GEMINI_API_KEY or GOOGLE_API_KEY environment variable

Alternative provider: Atlas Cloud

-p atlas generates through Atlas Cloud, which serves the same Nano Banana Pro model over a submit-then-poll REST API. Useful when a Google AI Studio key is not available. Requires ATLASCLOUD_API_KEY; the default provider is unchanged.

codev generate-image "A sunset over mountains" -p atlas -a 16:9

Measured differences on that path:

-a/--aspect works (1:1 returns 1024x1024, 16:9 returns 1376x768).
-r/--resolution has no equivalent field; a note is printed and the model's default resolution comes back.
--ref is not supported (text-to-image only) and exits with an error rather than silently ignoring the images.
The model returns JPEG, so the output file is named after its actual bytes instead of writing JPEG into the default output.png.

MuAPI provider

-p muapi uses MuAPI's Nano Banana Pro endpoint with the same aspect-ratio and resolution controls. Set MUAPI_API_KEY (or MU_API_KEY) using the MuAPI access keys page. Reference images are uploaded to MuAPI and sent to the edit endpoint; returned media is downloaded only over HTTPS.

codev generate-image "A sunset over mountains" -p muapi -a 16:9
codev generate-image "Keep the subject, change the lighting" -p muapi --ref subject.png

The provider submits a job, polls the MuAPI image API, and writes the returned image locally. Polling and individual requests are bounded, and the API key is never sent to the returned media host.

---name: generate-imagedescription: AI image generation via Gemini with optional async providers. Use when the user wants to generate, create, or make an image, or when you need to create visual assets like logos, diagrams, or illustrations. Requires the API key for the selected provider.---# generate-image - AI Image GenerationUses Google Gemini to generate images from text prompts.## Synopsis```codev generate-image "<prompt>" [options]```Note: this is a `codev` subcommand, not standalone.## All flags```-o, --output <file> Output file path (default: output.png)-r, --resolution <res> Resolution: 1K, 2K, 4K (default: 1K)-a, --aspect <ratio> Aspect ratio (default: 1:1)--ref <image> Reference image (repeatable, max 14)-p, --provider <name> Provider name (default: gemini)```## Aspect ratios`1:1` | `16:9` | `9:16` | `3:4` | `4:3` | `3:2` | `2:3`## Examples```bashcodev generate-image "A sunset over mountains"codev generate-image "A futuristic city" -r 4K -a 16:9 -o city.pngcodev generate-image "Same style but with cats" --ref style.png --ref layout.pngcodev generate-image prompt.txt -o result.png # Prompt from .txt file```## Notes- Prompt must be quoted if it contains spaces- Prompt can be a `.txt` file path (auto-detected by extension)- Reference images must exist on disk- Requires `GEMINI_API_KEY` or `GOOGLE_API_KEY` environment variable## Alternative provider: Atlas Cloud`-p atlas` generates through Atlas Cloud, which serves the same Nano Banana Promodel over a submit-then-poll REST API. Useful when a Google AI Studio key isnot available. Requires `ATLASCLOUD_API_KEY`; the default provider is unchanged.```bashcodev generate-image "A sunset over mountains" -p atlas -a 16:9```Measured differences on that path:- `-a/--aspect` works (`1:1` returns 1024x1024, `16:9` returns 1376x768).- `-r/--resolution` has no equivalent field; a note is printed and the model's default resolution comes back.- `--ref` is not supported (text-to-image only) and exits with an error rather than silently ignoring the images.- The model returns JPEG, so the output file is named after its actual bytes instead of writing JPEG into the default `output.png`.## MuAPI provider`-p muapi` uses MuAPI's Nano Banana Pro endpoint with the same aspect-ratio andresolution controls. Set `MUAPI_API_KEY` (or `MU_API_KEY`) using the [MuAPIaccess keys page](https://muapi.ai/access-keys). Reference images are uploadedto MuAPI and sent to the edit endpoint; returned media is downloaded only overHTTPS.```bashcodev generate-image "A sunset over mountains" -p muapi -a 16:9codev generate-image "Keep the subject, change the lighting" -p muapi --ref subject.png```The provider submits a job, polls the [MuAPI image API](https://muapi.ai/ai-image-api),and writes the returned image locally. Polling and individual requests arebounded, and the API key is never sent to the returned media host.

Frequently asked questions