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:

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