Skill: Draw Things for AI Agents

Slug: drawthings-agent
Display Name: INLINECODE1

🛠 Setup & Verification (AI ACTION REQUIRED)

If dt-skill is not found or fails with "module not found", you MUST perform these steps:

1. 1. Global Installation: Run npm install -g @mijuu/drawthings to ensure the CLI and MCP entry points are available.
2. Verify Environment: Run dt-skill doctor. If paths are missing, ask the user for their Draw Things model and server binary paths, then run dt-skill config --server-path "..." --models-path "...".

🧩 Protocol Preference (CRITICAL for AI)

This skill provides two interfaces. You MUST follow this priority:

1. 1. Model Context Protocol (MCP): If you see the tool generate_image in your toolset, ALWAYS use it. It is the most reliable interface for AI.
2. CLI Interface (dt-skill): Use dt-skill gen ONLY 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: INLINECODE14
• For 4x Upscale: --upscale 4 (Note: Takes significantly longer)

Example: INLINECODE16

3. Aspect Ratio & Resolution

Default is 1024x576 (16:9).

• - Square: INLINECODE18
• Portrait: INLINECODE19
• Standard: INLINECODE20

4. Model Selection

• - Default: z_image_turbo_1.0_q6p.ckpt (Fastest, 8 steps).
• Listing Models: Use dt-skill models to 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

1. 1. NO TRUNCATION: Never use "..." or "etc." in the prompt. Provide the complete text.
2. NO POST-PROCESSING: Upscaling MUST be part of the initial gen command.
3. RESPONSE COMPRESSION: Ensure "Response Compression" (FPY) is DISABLED in Draw Things settings.

📋 Parameter Reference (CLI)

Parameter	Type	Description
INLINECODE28	String	(Required) Positive prompt
INLINECODE29

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) |