# Send ComfyUI ImageGen (Flux2) to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - Download the package from Yavira. - Extract it into a folder your agent can access. - Paste one of the prompts below and point your agent at the extracted folder. ## Suggested prompts ### New install ```text I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete. ``` ### Upgrade existing ```text I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "comfyui-imagegen", "name": "ComfyUI ImageGen (Flux2)", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/halr9000/comfyui-imagegen", "canonicalUrl": "https://clawhub.ai/halr9000/comfyui-imagegen", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/comfyui-imagegen", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=comfyui-imagegen", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "scripts/generate.py", "SKILL.md", "workflows/flux2.json" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "slug": "comfyui-imagegen", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-05-02T01:13:40.248Z", "expiresAt": "2026-05-09T01:13:40.248Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=comfyui-imagegen", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=comfyui-imagegen", "contentDisposition": "attachment; filename=\"comfyui-imagegen-1.5.0.zip\"", "redirectLocation": null, "bodySnippet": null, "slug": "comfyui-imagegen" }, "scope": "item", "summary": "Item download looks usable.", "detail": "Yavira can redirect you to the upstream package for this item.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/comfyui-imagegen" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/comfyui-imagegen", "downloadUrl": "https://openagent3.xyz/downloads/comfyui-imagegen", "agentUrl": "https://openagent3.xyz/skills/comfyui-imagegen/agent", "manifestUrl": "https://openagent3.xyz/skills/comfyui-imagegen/agent.json", "briefUrl": "https://openagent3.xyz/skills/comfyui-imagegen/agent.md" } } ``` ## Documentation ### Changelog [2026-02-11 10:10 EST]: v1.4.0 - Refactored prompting: agent converts human prompt to structured JSON string; script sends JSON directly as ComfyUI positive prompt (no prose conversion). Added text-in-image quoting rule. [2026-02-11 09:52 EST]: v1.3.0 - Script now accepts --structured-prompt JSON directly (auto-generates prose internally). Removed agent-side prose step. Updated usage/examples. [2026-02-11 09:20 EST]: v1.2.0 - Added structured prompt parsing: translate human requests into optional JSON schema fields, auto-generate optimized Flux.2 prose prompts. Updated description. [2026-02-11 00:15 EST]: v1.1.0 - Added --submit-only (fast prompt_id return) + --watch prompt_id modes. SKILL.md docs async flow: submit → sessions_spawn watcher sub-agent (polls every 5s, auto-sends image to Telegram, ~10x token savings vs. main-agent block). [2026-02-11 04:05 EST]: v1.0.3 - Added Flux.2 [klein] 9B prompting best practices section with guidelines from Black Forest Labs and fal.ai. [2026-02-10 23:05]: v1.0.2 - Workflow v3: "Image Save with Prompt/Info (WLSH)" (node 85) for improved metadata embedding. Script updated to poll node 85. [2026-02-10 23:00]: Added explicit instruction to always send generated image to user post-generation via message tool. [2026-02-10]: Updated to new workflow: JPG output with embedded prompt/metadata via "Image Save with Prompt File (WLSH)". Model changed to darkBeastFeb0826Latest_dbkBlitzV15.safetensors. Script now polls node 84. ### Usage Agent converts human request to mandatory structured JSON schema → compact string. Verify ComfyUI runs on localhost:8188. Async Mode (Recommended): 1. exec python skills/comfyui-imagegen/scripts/generate.py --structured-prompt '{"subjects":[{"description":"fluffy tabby cat","position":"center","action":"sitting relaxed"}],"scene":"cozy room interior","lighting":"warm golden sunset rays","mood":"serene and peaceful","camera":{"angle":"low angle"}}' --submit-only → parse prompt_id 2. sessions_spawn task="Set-Location 'C:\\\\Users\\\\hal\\\\.openclaw\\\\workspace'; python skills/comfyui-imagegen/scripts/generate.py --watch '{prompt_id}' --output ./gen-{prompt_id}.jpg; message action=send channel=telegram target=595846104 media=./gen-{prompt_id}.jpg; Remove-Item ./gen-{prompt_id}.jpg" label="img-{prompt_id}" cleanup=delete runTimeoutSeconds=180 Watcher polls /history/{prompt_id} every 5s (optimal: <5s latency, ~12 polls max @60s job, isolated tokens). Auto-sends JPG to this chat on completion (sub-agent pings back). Timeout implicitly via spawn runTimeoutSeconds=120. Sync Mode (blocks agent): exec python skills/comfyui-imagegen/scripts/generate.py --structured-prompt '{"scene":"your scene"}' [--seed N] [--steps 10] [--output ./my.jpg] [--host localhost:8188] message action=send channel=telegram media=./my.jpg Customize: ArgDefaultNotes--seedrandomRepro--steps520-50 quality--hostlocalhost:8188Remote--outputgen-{seed/pid}.jpgFull path ### Structured Prompt Schema (Mandatory Format) Agent step 1: Convert human natural language request into this exact JSON structure (all fields optional; populate only relevant; subjects array supports multiples). Rule: For text in images (signs, logos), surround in double quotes within description/action fields, e.g., "sign reading \\"STOP\\"" or "logo with text \\"OpenClaw\\"" { "scene": "overall scene description", "subjects": [ { "description": "detailed subject description", "position": "where in frame", "action": "what they're doing" } ], "style": "artistic style", "color_palette": ["#FF0000", "#00AACC"], "lighting": "lighting description", "mood": "emotional tone", "background": "background details", "composition": "framing and layout", "camera": { "angle": "camera angle", "lens": "lens type", "depth_of_field": "focus behavior" } } Agent step 2: Stringify JSON (compact, single-line for shell escaping), pass to script --structured-prompt (sent directly as ComfyUI positive prompt). Example: User: "A cat sitting on a windowsill at sunset" Structured JSON string (for --structured-prompt): '{"subjects":[{"description":"fluffy tabby cat","position":"center","action":"sitting relaxed"}],"scene":"cozy room interior","lighting":"warm golden sunset rays","mood":"serene and peaceful","camera":{"angle":"low angle"}}' ### Workflow Details Polls node 85 ("Image Save with Prompt/Info (WLSH)"). Model: darkBeastFeb0826Latest_dbkBlitzV15.safetensors Template: workflows/flux2.json ### Prompting Best Practices (Flux.2 [klein] 9B) Prose, not keywords. Subject → Scene → Lighting → Mood. E.g., "A serene mountain lake at dawn, mist rising, golden light piercing peaks, photorealistic." Sources: BFL, fal.ai ### Examples # Async test (structured JSON string → direct positive prompt) python .../generate.py --structured-prompt '{"subjects":[{"description":"fluffy tabby cat","position":"center","action":"sitting relaxed"}],"scene":"cozy room interior","lighting":"warm golden sunset rays","mood":"serene and peaceful","camera":{"angle":"low angle"}}' --submit-only --steps 10 # → prompt_id=abc123; spawn watcher sub-agent For cron alternative (less optimal): cron add one-shot at=now+10s payload.systemEvent="Check img job {prompt_id}" but spawn > cron for this. ## Trust - Source: tencent - Verification: Indexed source record - Publisher: halr9000 - Version: 1.5.0 ## Source health - Status: healthy - Item download looks usable. - Yavira can redirect you to the upstream package for this item. - Health scope: item - Reason: direct_download_ok - Checked at: 2026-05-02T01:13:40.248Z - Expires at: 2026-05-09T01:13:40.248Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/comfyui-imagegen) - [Send to Agent page](https://openagent3.xyz/skills/comfyui-imagegen/agent) - [JSON manifest](https://openagent3.xyz/skills/comfyui-imagegen/agent.json) - [Markdown brief](https://openagent3.xyz/skills/comfyui-imagegen/agent.md) - [Download page](https://openagent3.xyz/downloads/comfyui-imagegen)