/install drawthings-agent
Skill: Draw Things for AI Agents
Slug: drawthings-agent
Display Name: Draw Things for AI Agents
🛠 Setup & Verification (AI ACTION REQUIRED)
If dt-skill is not found or fails with "module not found", you MUST perform these steps:
- Global Installation: Run
npm install -g @mijuu/drawthingsto ensure the CLI and MCP entry points are available. - Verify Environment: Run
dt-skill doctor. If paths are missing, ask the user for their Draw Things model and server binary paths, then rundt-skill config --server-path "..." --models-path "...".
🧩 Protocol Preference (CRITICAL for AI)
This skill provides two interfaces. You MUST follow this priority:
- Model Context Protocol (MCP): If you see the tool
generate_imagein your toolset, ALWAYS use it. It is the most reliable interface for AI. - CLI Interface (dt-skill): Use
dt-skill genONLY if the MCP tool is missing or for server management (e.g.,dt-skill server start).
🛠 Target Tool
- MCP Tool:
generate_image(Preferred) - CLI Command:
dt-skill gen(Fallback)
🤖 AI Usage Instructions
1. Basic Generation
- MCP: Call
generate_image(prompt: "..."). - CLI: Run
dt-skill gen --prompt "...". You MUST provide a detailed prompt.
2. High Quality & Upscaling (CRITICAL)
If the user asks for "high quality", "high resolution", "4K", or "clear" images, you MUST use the --upscale parameter at the time of generation.
- For 2x Upscale:
--upscale 2 - For 4x Upscale:
--upscale 4(Note: Takes significantly longer) Example:dt-skill gen --prompt "..." --upscale 2
3. Aspect Ratio & Resolution
Default is 1024x576 (16:9).
- Square:
--width 1024 --height 1024 - Portrait:
--width 576 --height 1024 - Standard:
--width 1024 --height 576
4. Model Selection
- Default:
z_image_turbo_1.0_q6p.ckpt(Fastest, 8 steps). - Listing Models: Use
dt-skill modelsto see what is available before suggesting a change.
5. Task Control & Sessions
When running in environments that support background tasks (like OpenClaw or OpenCode), use is_background: true to allow real-time progress monitoring.
- Progress: You will see
Sampling step: X/Y. - Heartbeat: Every 30s you will see
... still working .... - Timeout: Default is 600s. For heavy 4x upscales, use
--timeout 1200.
⚠️ CRITICAL CONSTRAINTS for AI
- NO TRUNCATION: Never use "..." or "etc." in the prompt. Provide the complete text.
- NO POST-PROCESSING: Upscaling MUST be part of the initial
gencommand. - RESPONSE COMPRESSION: Ensure "Response Compression" (FPY) is DISABLED in Draw Things settings.
📋 Parameter Reference (CLI)
| Parameter | Type | Description |
|---|---|---|
--prompt |
String | (Required) Positive prompt |
--negative-prompt |
String | Elements to exclude |
--upscale |
Number | 1, 2, or 4 |
--model |
String | Filename of the model |
--steps |
Number | Number of sampling steps (8-30) |
--seed |
Number | 0 for random, or specific number |
--output |
Path | Custom path for result |
--timeout |
Number | Max runtime in seconds (Default 600) |
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install drawthings-agent - After installation, invoke the skill by name or use
/drawthings-agent - Provide required inputs per the skill's parameter spec and get structured output
What is Drawthings Agent?
Generate images using Draw Things app via dt-skill CLI or MCP. It is an AI Agent Skill for Claude Code / OpenClaw, with 141 downloads so far.
How do I install Drawthings Agent?
Run "/install drawthings-agent" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Drawthings Agent free?
Yes, Drawthings Agent is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Drawthings Agent support?
Drawthings Agent is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Drawthings Agent?
It is built and maintained by mijuu (@mijuu); the current version is v0.1.1.