zimage-generation — Claude Code skill for image generation
This skill sends a text prompt to Z-Image through the ModelScope API and saves the generated image. Use it when an agent needs to create an image from a description.
npx skills add Toolsai/Free-Zimage-Skills --skill zimage-generation -a claude-codeWhat zimage-generation does
The skill runs scripts/generate_zimage.py, a Python script that calls the ModelScope Inference API. Provide a prompt, choose where to save the result with --output or -o, and optionally select a model with --model.
It requires Python 3, the requests package, and a ModelScope API key. Supply the key with --api-key, place it in the script’s DEFAULT_API_KEY variable, or save it as MODELSCOPE_API_TOKEN in scripts/.env. The script will not run without Python 3 and requests.
A 401 response that refers to Alibaba Cloud account binding means ModelScope access needs that account link. Sign in to ModelScope and bind the Alibaba Cloud account before using the API.
What it helps with
- generate an image from a text prompt
- choose an output file for the generated image
- select a model with
--model - pass a ModelScope API key at launch
Example prompts for the agent
- Generate a Z-Image illustration of a quiet street at dusk.
- Create an image from this description and save it as
cover.png. - Use model
model-idand my ModelScope key to generate an image.
How to install zimage-generation
1Skills CLI (Vercel)
npx skills add Toolsai/Free-Zimage-Skills --skill zimage-generation -a claude-code2Manually: put the files in place
~/.claude/skills/zimage-generation/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/zimage-generation/
1Skills CLI (Vercel)
npx skills add Toolsai/Free-Zimage-Skills --skill zimage-generation -a codex2Manually: put the files in place
.agents/skills/zimage-generation/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add Toolsai/Free-Zimage-Skills --skill zimage-generation -a cursor2Manually: put the files in place
.cursor/skills/zimage-generation/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install Toolsai/Free-Zimage-Skills zimage-generation2Manually: put the files in place
.github/skills/zimage-generation/SKILL.md1Skills CLI (Vercel)
npx skills add Toolsai/Free-Zimage-Skills --skill zimage-generation -a gemini-cli2Platform CLI
gemini skills install https://github.com/Toolsai/Free-Zimage-SkillsManually: put the files in place
.devin/skills/zimage-generation/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add Toolsai/Free-Zimage-Skills --skill zimage-generation -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about zimage-generation
How do I install zimage-generation in Claude Code?
Run npx skills add Toolsai/Free-Zimage-Skills --skill zimage-generation -a claude-code. The skill file will be at ~/.claude/skills/zimage-generation/SKILL.md.
What does zimage-generation do?
It passes a text prompt to Z-Image through the ModelScope Inference API and generates an image using a Python script.
What does zimage-generation need to run?
It needs Python 3, the requests package, and a ModelScope API key. Provide the key with --api-key, set it in the script, or store it in scripts/.env.
