image-generation

name	image-generation
description	Use when the user asks to create, generate, or render images through the internal media CLI.
allowed-tools	["Bash"]
user-invocable	true
disable-model-invocation	false
requires-action	true

Use foreground Bash only. allowed-tools is guidance, not the enforcement boundary; media generation is enforced by the internal tool permission path. Progress-only or promise-only replies are not completion: after activation, either run imagegen or report the concrete blocker plainly.

• Run one imagegen --prompt ... --count ... command for one logical request.
• Set an explicit long Bash timeout within the current Bash cap before running the command.
• When the user asks for multiple images from one prompt, pass the requested number through --count instead of issuing repeated --count 1 commands.
• Treat --prompt as literal text unless it names a workspace-relative file; prompt file paths should be passed through --prompt.
• Use --prompt-reference only when the request supplies additional prompt context.
• Use --aspect, --purpose, or --retry-from-error-json only when the request or retry context requires them.
• To override the connected default, pass --provider <id> --model <id> together — both are required, or pass neither. Omit them to use the configured default provider/model.
• If image generation fails or the media runtime is unavailable, report that plainly.
• Do not hand-author SVG, ASCII art, placeholder files, or other substitutes and present them as generated images.