image-gen
xerrors/Yuxi · Agent Skill
Generates images, posters, and illustrations from text descriptions, saving them to outputs.
Jump to install ↓Overview
| Publisher | |
|---|---|
| Repository | xerrors/Yuxi ↗ |
| Skill folder | image-gen |
| Stars | 6,725 |
| Bundled files | 1 |
| License | MIT |
| Last updated | August 20, 2026 |
| Links | Skill source ↗ · Repository ↗ |
Mozgi check
What we found in the skill files. Details come with a subscription.
Installation
A skill is a folder with a SKILL.md file. Pick your agent and run the commands in a terminal (macOS, Linux or Git Bash on Windows) from your project root.
Copy the prompt into Claude, Codex or another assistant: it will review the skill and install it for you.
Install the “image-gen” skill from mozgi.io (https://mozgi.io/skills/image-gen/) for me. 1. Download the archive: https://mozgi.io/skills/image-gen/download If it fails, take the skill folder from the source: https://github.com/xerrors/Yuxi/tree/main/backend/package/yuxi/agents/skills/buildin/image-gen 2. Read SKILL.md and the other files. Check the skill is safe: no hidden commands, no sending data elsewhere, no scripts doing something other than described. If anything looks suspicious, stop and tell me. 3. Put the “image-gen” folder into your agent's skills folder: .claude/skills/ for Claude Code, .agents/skills/ for Codex, .cursor/skills/ for Cursor, .gemini/skills/ for Gemini CLI. Inside the project if we are in one, otherwise in the home folder (~/.claude/skills/ etc.). 4. Make sure <skills folder>/image-gen/SKILL.md exists. 5. Briefly tell me what this skill does and offer to try it on my task. If you cannot do a step yourself, tell me what to click or type.
git clone --depth 1 --branch main https://github.com/xerrors/Yuxi.git /tmp/Yuxi mkdir -p .claude/skills cp -r /tmp/Yuxi/backend/package/yuxi/agents/skills/buildin/image-gen .claude/skills/image-gen
Restart Claude Code — the skill appears in the list; call it manually with /image-gen. For all projects use ~/.claude/skills.
git clone --depth 1 --branch main https://github.com/xerrors/Yuxi.git /tmp/Yuxi mkdir -p .agents/skills cp -r /tmp/Yuxi/backend/package/yuxi/agents/skills/buildin/image-gen .agents/skills/image-gen
Codex looks for skills in .agents/skills from the current folder up to the repo root; call one with /skills or $image-gen. For all projects use ~/.agents/skills.
git clone --depth 1 --branch main https://github.com/xerrors/Yuxi.git /tmp/Yuxi mkdir -p .cursor/skills cp -r /tmp/Yuxi/backend/package/yuxi/agents/skills/buildin/image-gen .cursor/skills/image-gen
Cursor picks the skill up on start; call it with “/” in Agent chat. Cursor also reads .claude/skills and .agents/skills. For all projects use ~/.cursor/skills.
git clone --depth 1 --branch main https://github.com/xerrors/Yuxi.git /tmp/Yuxi mkdir -p .gemini/skills cp -r /tmp/Yuxi/backend/package/yuxi/agents/skills/buildin/image-gen .gemini/skills/image-gen
Gemini CLI offers to activate the skill when a task matches — you approve it. For all projects use ~/.gemini/skills.
Read SKILL.md and any companion files before deciding whether to install. Click a file to preview it.
SKILL.md contents
Original author text · read-only图片生成技能
当用户要求生成图片、海报、插画、文生图,或明确提到 Qwen-Image 时,使用此技能组织图片生成流程。
默认生成接口
默认使用 SiliconFlow 的 Qwen-Image 接口:
- Endpoint:
POST https://api.siliconflow.cn/v1/images/generations - Model:
Qwen/Qwen-Image - 默认参数:
negative_prompt:""num_inference_steps:20guidance_scale:7.5
调用外部接口时,必须在 Agent 沙盒执行环境中读取 SILICONFLOW_API_KEY。不要依赖后端进程环境变量。
操作流程
1. 明确用户要生成的图片内容、风格、尺寸或约束;信息不足但不影响生成时,使用合理默认值,不要反复追问。
2. 使用可用的执行工具在沙盒中运行脚本,调用图片生成接口,传入用户需求整理后的 prompt,并按需传入 negative_prompt、num_inference_steps、guidance_scale。
3. 从生成接口响应中读取图片地址,默认路径为 images[0].url。
4. 在同一个沙盒脚本中用 Authorization: Bearer $SILICONFLOW_API_KEY 下载该图片地址;如果接口直接返回 base64,则直接解码保存。
5. 将最终图片保存到当前 Workdir 的 outputs/ 下,例如 outputs/generated-image.png。
6. 调用 present_artifacts,传入保存后的 outputs 虚拟路径,让前端展示图片产物。
7. 最终回复简要说明图片已生成,不要把外部临时 URL 当作最终结果展示。
脚本示例
可根据用户需求调整 prompt 和输出文件名:
import os
import requests
from pathlib import Path
api_key = os.environ["SILICONFLOW_API_KEY"]
prompt = "根据用户需求整理后的图片提示词"
response = requests.post(
"https://api.siliconflow.cn/v1/images/generations",
headers={"Authorization": f"Bearer {api_key}", "Content-Type": "application/json"},
json={
"model": "Qwen/Qwen-Image",
"prompt": prompt,
"negative_prompt": "",
"num_inference_steps": 20,
"guidance_scale": 7.5,
},
timeout=120,
)
response.raise_for_status()
image_url = response.json()["images"][0]["url"]
image_response = requests.get(
image_url,
headers={"Authorization": f"Bearer {api_key}"},
timeout=120,
)
image_response.raise_for_status()
output_path = Path("outputs/generated-image.png")
output_path.parent.mkdir(parents=True, exist_ok=True)
output_path.write_bytes(image_response.content)
print(output_path.as_posix())
多模型扩展
如果用户指定其它图片生成模型或兼容接口,可以按该接口的协议先生成图片。只要最终拿到图片 bytes 或 base64,就保存到当前 Workdir 的 outputs/,再调用 present_artifacts 展示。
关键约束
- 不要把外部生成接口返回的临时 URL 当作最终结果直接展示给用户。
- 不要调用后端 MinIO 上传工具;图片生成和下载都应在沙盒内完成。
- 如果
SILICONFLOW_API_KEY缺失,应明确提示用户需要在 Agent 沙盒环境变量中配置。 - 保存到 outputs 后必须调用
present_artifacts,否则前端不会自动展示生成图片。
Frequently asked questions
What does the image-gen skill do?
Generates images, posters, and illustrations from text descriptions, saving them to outputs.
How do I install image-gen?
Open the “Installation” block on this page and pick your agent — Claude Code, Codex, Cursor or Gemini CLI — for ready-made commands that copy the skill folder to the right place. Or copy the prompt from the “Via assistant” tab and let the assistant review and install the skill.
Which AI models work with image-gen?
Skills are plain Markdown instructions (the Agent Skills format), so image-gen works with any agent that reads SKILL.md: Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode and more. The model loads the instructions only when a task matches the skill's description.
Is image-gen free?
The skill is published openly by xerrors under the MIT license. The skill itself costs nothing — you only pay your AI provider for the tokens you use.
Is it safe to install skills?
A skill is a set of instructions your agent will follow, so read SKILL.md and its companion files before installing. Scripts in the skill folder only run if your agent runs them — keep an eye on what it does and do not grant unnecessary permissions.
How is a skill different from an MCP server or a plugin?
An MCP server or plugin gives the model new tools — code that runs and returns a result. A skill gives it knowledge and process: how to approach a task, which steps to follow and what good output looks like. It needs no server or API key.