# Send Windmill to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - Download the package from Yavira. - Extract it into a folder your agent can access. - Paste one of the prompts below and point your agent at the extracted folder. ## Suggested prompts ### New install ```text I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete. ``` ### Upgrade existing ```text I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "windmill", "name": "Windmill", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/ivangdavila/windmill", "canonicalUrl": "https://clawhub.ai/ivangdavila/windmill", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/windmill", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=windmill", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "SKILL.md" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "slug": "windmill", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-05-11T02:41:59.582Z", "expiresAt": "2026-05-18T02:41:59.582Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=windmill", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=windmill", "contentDisposition": "attachment; filename=\"windmill-1.0.0.zip\"", "redirectLocation": null, "bodySnippet": null, "slug": "windmill" }, "scope": "item", "summary": "Item download looks usable.", "detail": "Yavira can redirect you to the upstream package for this item.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/windmill" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/windmill", "downloadUrl": "https://openagent3.xyz/downloads/windmill", "agentUrl": "https://openagent3.xyz/skills/windmill/agent", "manifestUrl": "https://openagent3.xyz/skills/windmill/agent.json", "briefUrl": "https://openagent3.xyz/skills/windmill/agent.md" } } ``` ## Documentation ### Script Traps Main function signature determines input schema — Windmill infers from type hints, wrong types break the UI form Return value is the script output — forgetting to return means downstream steps get nothing Python dependencies go in inline requirements.txt comment — not a global file, each script is isolated TypeScript runs on Bun — Node.js-specific APIs may not work ### Flow Execution results.step_name fails if step hasn't run yet — conditional branches cause undefined access errors Parallel branches need explicit configuration — default is sequential, not concurrent Suspend steps wait forever without timeout — set explicit timeout or flow hangs indefinitely Error handlers only catch step failures — script syntax errors bypass handlers ### Scheduling Pitfalls Timezone defaults to server timezone — set explicitly or jobs fire at unexpected times Concurrent execution allowed by default — add mutex lock if jobs shouldn't overlap Schedules attach to scripts/flows — no standalone schedule entities, delete script = delete schedule ### Secrets and Variables Secrets cannot be read back from UI after creation — store originals securely elsewhere Variables are plaintext and visible — never put sensitive data in variables, only secrets Path format matters — u/username/secret for user, f/folder/secret for shared ### Self-Hosting PostgreSQL is the only state — workers are stateless, back up only the database Single container includes workers — fine for small loads, separate workers for scale Worker count determines parallelism — one worker = one concurrent script execution ### Webhook Triggers Each script/flow gets unique webhook URL — changes if you rename the script Webhook payload becomes script input — schema must match expected arguments No built-in auth on webhooks — validate tokens in script logic or use reverse proxy ### Common Mistakes Testing flows without testing scripts first — debug scripts individually Expecting state between runs — use variables or external storage for persistence Hardcoding paths — use wmill.get_resource() for portability between workspaces ## Trust - Source: tencent - Verification: Indexed source record - Publisher: ivangdavila - Version: 1.0.0 ## Source health - Status: healthy - Item download looks usable. - Yavira can redirect you to the upstream package for this item. - Health scope: item - Reason: direct_download_ok - Checked at: 2026-05-11T02:41:59.582Z - Expires at: 2026-05-18T02:41:59.582Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/windmill) - [Send to Agent page](https://openagent3.xyz/skills/windmill/agent) - [JSON manifest](https://openagent3.xyz/skills/windmill/agent.json) - [Markdown brief](https://openagent3.xyz/skills/windmill/agent.md) - [Download page](https://openagent3.xyz/downloads/windmill)