custom-claude-skills/skills/minimax-image/SKILL.md

name, description, allowed-tools

name	description	allowed-tools
minimax-image	Generate one or more images from a text prompt via the MiniMax image API. Use when the user wants an illustration, picture, logo, concept art, sprite, icon, or visual. Trigger on phrases like "draw", "generate an image", "create a picture", "make a sprite", "render", "show me what X looks like".	Bash(minimax-gen image *), Bash(minimax-gen --help), Bash(mkdir *), Bash(ls *), Bash(test *), Bash(file *), Read

/minimax-image — Image Generation

Generate images from a text prompt. Single image or batch.

CLI

# Single image
minimax-gen image "A castle on a hill at sunset, painterly" \
  --aspect-ratio 16:9 \
  --out /tmp/castle.png

# Multiple images into a directory
minimax-gen image "A red apple, studio lighting" \
  --out /tmp/apples/ --n 4 --aspect-ratio 1:1

# Wider aspect for landscape scenes
minimax-gen image "Mountain valley at dawn, fog" \
  --aspect-ratio 21:9 --out /tmp/valley.png

The CLI is at ~/dev/claude/gamedev/minimax-gen/bin/minimax-gen.

Aspect ratios

1:1 (default), 16:9, 4:3, 3:2, 2:3, 3:4, 9:16, 21:9.

Choose based on the use case:

• Sprites / icons → 1:1
• Wallpapers / backgrounds → 16:9 or 21:9
• Portraits / character → 2:3 or 9:16

Or pass --width and --height (both must be set, divisible by 8, 512–2048).

Output format

The CLI writes whatever format the API returns (typically JPEG). The --out suffix is corrected to match (/tmp/castle.png written as /tmp/castle.jpg if the API returns JPEG). A sidecar .meta.json carries the prompt, trace_id, and source URL.

Tips

• --prompt-optimizer lets the API rewrite the prompt for better results.
• --seed N makes the result reproducible.
• URLs from the API expire in 24h — the CLI downloads the bytes so the file is yours to keep.

After the call

1. Show the path(s) written and the trace_id from the sidecar.
2. Suggest variations (different aspect, seed, prompt-optimizer on).
3. Do NOT print the meta JSON — point at the file.

Never do

• Never echo, log, or commit the contents of ~/.claude-secrets/minimax-auth-token.

Reference

Full option list: minimax-gen image --help