How do I install the Smtools Image Generation skill?

Run npx skillmds@latest add dvcrn/smtools-image-generation 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 Smtools Image Generation safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: executes scripts. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Smtools Image Generation?

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 Smtools Image Generation free to use?

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

Who published Smtools Image Generation?

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

Smtools Image Generation by dvcrn — Agent Skill

Name: Smtools Image Generation
Rating: 4.666666666666667 (3 reviews)
Author: dvcrn

File contents

Image Generation Skill

Generate images from text prompts. Default provider is OpenRouter (synchronous). Alternative: Kie.ai (async, task-based).

When to Activate

Activate when the user asks to:

Generate, create, draw, paint, illustrate, or render an image
Make a picture, artwork, photo, or illustration
Visualize something as an image

How to Use

Run the generation script with an absolute path to avoid directory change prompts:

bash SKILL_DIR/scripts/run.sh --prompt "PROMPT" [OPTIONS]

Replace SKILL_DIR with the absolute path to this skill's root directory.

Options

Flag	Description
`-p, --prompt`	Text prompt (required)
`--provider`	`openrouter` (default) or `kie`
`-m, --model`	Model name (provider-specific)
`-o, --output`	Output file path
`-c, --config`	Path to config.json
`--list-models`	List available models
`-v, --verbose`	Debug output to stderr

Output

The script outputs JSON to stdout:

{"status": "ok", "image_path": "/absolute/path/to/image.png", "model": "google/gemini-3.1-flash-image-preview", "provider": "openrouter"}

After successful generation, show the user the image path and confirm the image was created.

Provider Selection

OpenRouter (default): Fast, synchronous. Models: google/gemini-3.1-flash-image-preview, google/imagen-4, stabilityai/stable-diffusion-3. Requires OPENROUTER_API_KEY.
Kie.ai: Async task-based. Models: flux-ai, midjourney, google-4o-image, ghibli-ai. Requires KIE_API_KEY. Use when the user explicitly requests Kie.ai or a Kie-specific model.

Examples

Basic generation:

bash SKILL_DIR/scripts/run.sh -p "A serene mountain lake at sunset"

Specific model:

bash SKILL_DIR/scripts/run.sh -p "Cyberpunk cityscape" -m "google/imagen-4"

Kie.ai provider:

bash SKILL_DIR/scripts/run.sh -p "Studio Ghibli forest" --provider kie -m ghibli-ai

Custom output path:

bash SKILL_DIR/scripts/run.sh -p "A red fox" -o /tmp/fox.png

Error Handling

Error	Action
Missing API key	Tell the user to set the environment variable (`OPENROUTER_API_KEY` or `KIE_API_KEY`)
Network/timeout error	Retry once. If still failing, inform the user
No image in response	Show the raw error from the JSON output
Kie.ai task timeout	Inform user that generation took too long, suggest retrying

Setup

If the skill has not been set up yet, run:

bash SKILL_DIR/setup.sh

Security

Never display or log API keys
Never modify config.json without user permission

---name: smtools-image-generationdescription: Generate images from text prompts using AI models via OpenRouter or Kie.ai. Use when the user asks to generate, create, draw, or illustrate an image.---# Image Generation SkillGenerate images from text prompts. Default provider is **OpenRouter** (synchronous). Alternative: **Kie.ai** (async, task-based).## When to ActivateActivate when the user asks to:- Generate, create, draw, paint, illustrate, or render an image- Make a picture, artwork, photo, or illustration- Visualize something as an image## How to UseRun the generation script with an absolute path to avoid directory change prompts:```bashbash SKILL_DIR/scripts/run.sh --prompt "PROMPT" [OPTIONS]```Replace `SKILL_DIR` with the absolute path to this skill's root directory.### Options| Flag | Description ||------|-------------|| `-p, --prompt` | Text prompt (required) || `--provider` | `openrouter` (default) or `kie` || `-m, --model` | Model name (provider-specific) || `-o, --output` | Output file path || `-c, --config` | Path to config.json || `--list-models` | List available models || `-v, --verbose` | Debug output to stderr |### OutputThe script outputs JSON to stdout:```json{"status": "ok", "image_path": "/absolute/path/to/image.png", "model": "google/gemini-3.1-flash-image-preview", "provider": "openrouter"}```After successful generation, show the user the image path and confirm the image was created.## Provider Selection- **OpenRouter** (default): Fast, synchronous. Models: `google/gemini-3.1-flash-image-preview`, `google/imagen-4`, `stabilityai/stable-diffusion-3`. Requires `OPENROUTER_API_KEY`.- **Kie.ai**: Async task-based. Models: `flux-ai`, `midjourney`, `google-4o-image`, `ghibli-ai`. Requires `KIE_API_KEY`. Use when the user explicitly requests Kie.ai or a Kie-specific model.## ExamplesBasic generation:```bashbash SKILL_DIR/scripts/run.sh -p "A serene mountain lake at sunset"```Specific model:```bashbash SKILL_DIR/scripts/run.sh -p "Cyberpunk cityscape" -m "google/imagen-4"```Kie.ai provider:```bashbash SKILL_DIR/scripts/run.sh -p "Studio Ghibli forest" --provider kie -m ghibli-ai```Custom output path:```bashbash SKILL_DIR/scripts/run.sh -p "A red fox" -o /tmp/fox.png```## Error Handling| Error | Action ||-------|--------|| Missing API key | Tell the user to set the environment variable (`OPENROUTER_API_KEY` or `KIE_API_KEY`) || Network/timeout error | Retry once. If still failing, inform the user || No image in response | Show the raw error from the JSON output || Kie.ai task timeout | Inform user that generation took too long, suggest retrying |## SetupIf the skill has not been set up yet, run:```bashbash SKILL_DIR/setup.sh```## Security- Never display or log API keys- Never modify config.json without user permission

Frequently asked questions

Smtools Image Generation