{
  "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": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/windmill",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=windmill",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "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."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "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."
        },
        {
          "label": "Upgrade existing",
          "body": "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."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-07T17:22:31.273Z",
      "expiresAt": "2026-05-14T17:22:31.273Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
        "contentDisposition": "attachment; filename=\"afrexai-annual-report-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "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."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/windmill",
    "agentPageUrl": "https://openagent3.xyz/skills/windmill/agent",
    "manifestUrl": "https://openagent3.xyz/skills/windmill/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/windmill/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "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."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "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."
      },
      {
        "label": "Upgrade existing",
        "body": "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."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Script Traps",
        "body": "Main function signature determines input schema — Windmill infers from type hints, wrong types break the UI form\nReturn value is the script output — forgetting to return means downstream steps get nothing\nPython dependencies go in inline requirements.txt comment — not a global file, each script is isolated\nTypeScript runs on Bun — Node.js-specific APIs may not work"
      },
      {
        "title": "Flow Execution",
        "body": "results.step_name fails if step hasn't run yet — conditional branches cause undefined access errors\nParallel branches need explicit configuration — default is sequential, not concurrent\nSuspend steps wait forever without timeout — set explicit timeout or flow hangs indefinitely\nError handlers only catch step failures — script syntax errors bypass handlers"
      },
      {
        "title": "Scheduling Pitfalls",
        "body": "Timezone defaults to server timezone — set explicitly or jobs fire at unexpected times\nConcurrent execution allowed by default — add mutex lock if jobs shouldn't overlap\nSchedules attach to scripts/flows — no standalone schedule entities, delete script = delete schedule"
      },
      {
        "title": "Secrets and Variables",
        "body": "Secrets cannot be read back from UI after creation — store originals securely elsewhere\nVariables are plaintext and visible — never put sensitive data in variables, only secrets\nPath format matters — u/username/secret for user, f/folder/secret for shared"
      },
      {
        "title": "Self-Hosting",
        "body": "PostgreSQL is the only state — workers are stateless, back up only the database\nSingle container includes workers — fine for small loads, separate workers for scale\nWorker count determines parallelism — one worker = one concurrent script execution"
      },
      {
        "title": "Webhook Triggers",
        "body": "Each script/flow gets unique webhook URL — changes if you rename the script\nWebhook payload becomes script input — schema must match expected arguments\nNo built-in auth on webhooks — validate tokens in script logic or use reverse proxy"
      },
      {
        "title": "Common Mistakes",
        "body": "Testing flows without testing scripts first — debug scripts individually\nExpecting state between runs — use variables or external storage for persistence\nHardcoding paths — use wmill.get_resource() for portability between workspaces"
      }
    ],
    "body": "Script Traps\nMain function signature determines input schema — Windmill infers from type hints, wrong types break the UI form\nReturn value is the script output — forgetting to return means downstream steps get nothing\nPython dependencies go in inline requirements.txt comment — not a global file, each script is isolated\nTypeScript runs on Bun — Node.js-specific APIs may not work\nFlow Execution\nresults.step_name fails if step hasn't run yet — conditional branches cause undefined access errors\nParallel branches need explicit configuration — default is sequential, not concurrent\nSuspend steps wait forever without timeout — set explicit timeout or flow hangs indefinitely\nError handlers only catch step failures — script syntax errors bypass handlers\nScheduling Pitfalls\nTimezone defaults to server timezone — set explicitly or jobs fire at unexpected times\nConcurrent execution allowed by default — add mutex lock if jobs shouldn't overlap\nSchedules attach to scripts/flows — no standalone schedule entities, delete script = delete schedule\nSecrets and Variables\nSecrets cannot be read back from UI after creation — store originals securely elsewhere\nVariables are plaintext and visible — never put sensitive data in variables, only secrets\nPath format matters — u/username/secret for user, f/folder/secret for shared\nSelf-Hosting\nPostgreSQL is the only state — workers are stateless, back up only the database\nSingle container includes workers — fine for small loads, separate workers for scale\nWorker count determines parallelism — one worker = one concurrent script execution\nWebhook Triggers\nEach script/flow gets unique webhook URL — changes if you rename the script\nWebhook payload becomes script input — schema must match expected arguments\nNo built-in auth on webhooks — validate tokens in script logic or use reverse proxy\nCommon Mistakes\nTesting flows without testing scripts first — debug scripts individually\nExpecting state between runs — use variables or external storage for persistence\nHardcoding paths — use wmill.get_resource() for portability between workspaces"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/ivangdavila/windmill",
    "publisherUrl": "https://clawhub.ai/ivangdavila/windmill",
    "owner": "ivangdavila",
    "version": "1.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "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"
  }
}