smtools-image-generation

name	smtools-image-generation
description	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 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