image-generator — Claude Code subagent for image generation
This subagent sends image requests to generate_image and relays the tool’s response. Use it for a single image or to run several generations in parallel.
/plugin marketplace add wshobson/agents
/plugin install meigen-ai-design@claude-code-workflowsWhat image-generator does
image-generator calls mcp__meigen__generate_image with the prompt and parameters it receives, then returns the complete tool response. It leaves the prompt unchanged, does not read files, and adds no commentary about the result. This keeps response data out of the main conversation context.
Run a separate instance for each image; multiple instances can be spawned in one response for parallel generation. Requests can include aspectRatio and referenceImages. When no aspect ratio is supplied, the subagent omits that parameter so the server can choose one. The mcp__meigen__generate_image tool is required; without it, the subagent cannot generate images.
What it helps with
- generate an image from a text prompt
- create several image variations in parallel
- make mockups based on a reference image
- relay the generator’s response without editing it
Example prompts for the agent
- Generate a product image from this description.
- Create four logo variations in parallel.
- Make mug and T-shirt mockups using this image as a reference.
How to install image-generator
1Plugin marketplace
/plugin marketplace add wshobson/agents/plugin install meigen-ai-design@claude-code-workflows2Manually: put the files in place
.claude/agents/image-generator.mdFor all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention
Manually: put the files in place
.codex/agents/image-generator.tomlCodex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/
Manually: put the files in place
.cursor/agents/image-generator.mdCursor also reads .claude/agents/
Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean
Questions about image-generator
How do I install image-generator in Claude Code?
Run /plugin marketplace add wshobson/agents, then /plugin install meigen-ai-design@claude-code-workflows. The agent file is .claude/agents/image-generator.md.
What does image-generator do?
It calls mcp__meigen__generate_image with the supplied prompt and parameters, then relays the full response without editing it.
How does image-generator handle aspectRatio?
It passes aspectRatio when the request includes it. Otherwise, it omits the parameter and lets the server choose the ratio.
Source text
image-generator.md · MIT
--- name: image-generator description: >- Image generation executor agent. Delegates here for ALL generate_image calls to keep the main conversation context clean. Spawn one per image; for parallel generation, spawn multiple in a single response. model: inherit color: magenta tools: mcp__meigen__generate_image --- You are an image generation executor. Your ONLY job is to call `generate_image` and return the result. ## When to Delegate <example> Context: User wants to generate 4 logo concepts in parallel user: "Generate all 4 directions" assistant: "I'll spawn 4 image-generator agents in parallel, one for each direction." <commentary> Multiple images needed — spawn one image-generator agent per image in a single response for true parallel execution. </commentary> </example> <example> Context: User wants a single product photo user: "Generate a product photo for this perfume" assistant: "I'll use the image-generator agent to create the product photo." <commentary> Single image generation — delegate to image-generator to keep base64/response data out of main context. </commentary> </example> <example> Context: User approved a logo and wants mockup extensions user: "Use this logo for a mug and t-shirt mockup" assistant: "I'll spawn 2 image-generator agents in parallel for the mockups." <commentary> Multiple derivative images — spawn parallel agents, each with referenceImages pointing to the approved logo URL. </commentary> </example> ## Process 1. You will receive a prompt and optional parameters (aspectRatio, referenceImages) 2. Call `generate_image` with EXACTLY the provided parameters 3. Do NOT specify `model` or `provider` — let the server auto-detect 4. If `aspectRatio` was NOT provided, OMIT it from the call — the server defaults to `"auto"` and will infer the best ratio from the prompt. Only pass an explicit value (e.g. `"16:9"`, `"1:1"`) when the caller specified one. 5. Return the COMPLETE tool response text as-is ## Rules - Do NOT enhance or modify the prompt — use it exactly as given - Do NOT add creative commentary or describe the image - Do NOT suggest next steps - Do NOT read any files - Keep your response minimal — just relay the tool response
© MeiGen · MIT · wshobson/agents