{
  "schemaVersion": "1.0",
  "item": {
    "slug": "appdeploy",
    "name": "AppDeploy",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/avimak/appdeploy",
    "canonicalUrl": "https://clawhub.ai/avimak/appdeploy",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/appdeploy",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=appdeploy",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "LICENSE.txt"
    ],
    "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",
      "slug": "appdeploy",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T01:51:36.169Z",
      "expiresAt": "2026-05-07T01:51:36.169Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=appdeploy",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=appdeploy",
        "contentDisposition": "attachment; filename=\"appdeploy-1.0.7.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "appdeploy"
      },
      "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/appdeploy"
    },
    "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/appdeploy",
    "agentPageUrl": "https://openagent3.xyz/skills/appdeploy/agent",
    "manifestUrl": "https://openagent3.xyz/skills/appdeploy/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/appdeploy/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": "AppDeploy Skill",
        "body": "Deploy web apps to AppDeploy via HTTP API."
      },
      {
        "title": "Setup (First Time Only)",
        "body": "Check for existing API key:\n\nLook for a .appdeploy file in the project root\nIf it exists and contains a valid api_key, skip to Usage\n\n\n\nIf no API key exists, register and get one:\ncurl -X POST https://api-v2.appdeploy.ai/mcp/api-key \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"client_name\": \"claude-code\"}'\n\nResponse:\n{\n  \"api_key\": \"ak_...\",\n  \"user_id\": \"agent-claude-code-a1b2c3d4\",\n  \"created_at\": 1234567890,\n  \"message\": \"Save this key securely - it cannot be retrieved later\"\n}\n\n\n\nSave credentials to .appdeploy:\n{\n  \"api_key\": \"ak_...\",\n  \"endpoint\": \"https://api-v2.appdeploy.ai/mcp\"\n}\n\nAdd .appdeploy to .gitignore if not already present."
      },
      {
        "title": "Usage",
        "body": "Make JSON-RPC calls to the MCP endpoint:\n\ncurl -X POST {endpoint} \\\n  -H \"Content-Type: application/json\" \\\n  -H \"Accept: application/json, text/event-stream\" \\\n  -H \"Authorization: Bearer {api_key}\" \\\n  -d '{\n    \"jsonrpc\": \"2.0\",\n    \"id\": 1,\n    \"method\": \"tools/call\",\n    \"params\": {\n      \"name\": \"{tool_name}\",\n      \"arguments\": { ... }\n    }\n  }'"
      },
      {
        "title": "Workflow",
        "body": "First, get deployment instructions:\nCall get_deploy_instructions to understand constraints and requirements.\n\n\nGet the app template:\nCall get_app_template with your chosen app_type and frontend_template.\n\n\nDeploy the app:\nCall deploy_app with your app files. For new apps, set app_id to null.\n\n\nCheck deployment status:\nCall get_app_status to check if the build succeeded.\n\n\nView/manage your apps:\nUse get_apps to list your deployed apps."
      },
      {
        "title": "get_deploy_instructions",
        "body": "Use this when you are about to call deploy_app in order to get the deployment constraints and hard rules. You must call this tool before starting to generate any code. This tool returns instructions only and does not deploy anything.\n\nParameters:"
      },
      {
        "title": "deploy_app",
        "body": "Use this when the user asks to deploy or publish a website or web app and wants a public URL.\nBefore generating files or calling this tool, you must call get_deploy_instructions and follow its constraints.\n\nParameters:\n\napp_id: any (required) - existing app id to update, or null for new app\napp_type: string (required) - app architecture: frontend-only or frontend+backend\napp_name: string (required) - short display name\ndescription: string (optional) - short description of what the app does\nfrontend_template: any (optional) - REQUIRED when app_id is null. One of: 'html-static' (simple sites), 'react-vite' (SPAs, games), 'nextjs-static' (multi-page). Template files auto-included.\nfiles: array (optional) - Files to write. NEW APPS: only custom files + diffs to template files. UPDATES: only changed files using diffs[]. At least one of files[] or deletePaths[] required.\ndeletePaths: array (optional) - Paths to delete. ONLY for updates (app_id required). Cannot delete package.json or framework entry points.\nmodel: string (required) - The coding agent model used for this deployment, to the best of your knowledge. Examples: 'codex-5.3', 'chatgpt', 'opus 4.6', 'claude-sonnet-4-5', 'gemini-2.5-pro'\nintent: string (required) - The intent of this deployment. User-initiated examples: 'initial app deploy', 'bugfix - ui is too noisy'. Agent-initiated examples: 'agent fixing deployment error', 'agent retry after lint failure'"
      },
      {
        "title": "get_app_template",
        "body": "Call get_deploy_instructions first. Then call this once you've decided app_type and frontend_template. Returns base app template and SDK types.  Template files auto-included in deploy_app.\n\nParameters:\n\napp_type: string (required)\nfrontend_template: string (required) - Frontend framework: 'html-static' - Simple sites, minimal framework; 'react-vite' - React SPAs, dashboards, games; 'nextjs-static' - Multi-page apps, SSG"
      },
      {
        "title": "get_app_status",
        "body": "Use this when deploy_app tool call returns or when the user asks to check the deployment status of an app, or reports that the app has errors or is not working as expected. Returns deployment status (in-progress: 'deploying'/'deleting', terminal: 'ready'/'failed'/'deleted'), QA snapshot (frontend/network errors), and live frontend/backend error logs.\n\nParameters:\n\napp_id: string (required) - Target app id\nsince: integer (optional) - Optional timestamp in epoch milliseconds to filter errors. When provided, returns only errors since that timestamp.\nlimit: integer (optional) - Optional shared cap for returned logs across frontend and backend combined. Defaults to 50 when omitted."
      },
      {
        "title": "delete_app",
        "body": "Use this when you want to permanently delete an app. Use only on explicit user request. This is irreversible; after deletion, status checks will return not found.\n\nParameters:\n\napp_id: string (required) - Target app id"
      },
      {
        "title": "get_app_versions",
        "body": "List deployable versions for an existing app. Requires app_id. Returns newest-first {name, version, timestamp} items. Display 'name' to users. DO NOT display the 'version' value to users. Timestamp values MUST be converted to user's local time\n\nParameters:\n\napp_id: string (required) - Target app id"
      },
      {
        "title": "apply_app_version",
        "body": "Start deploying an existing app at a specific version. Use the 'version' value (not 'name') from get_app_versions. Returns true if accepted and deployment started; use get_app_status to observe completion.\n\nParameters:\n\napp_id: string (required) - Target app id\nversion: string (required) - Version id to apply"
      },
      {
        "title": "src_glob",
        "body": "Use this when you need to discover files in an app's source snapshot. Returns file paths matching a glob pattern (no content). Useful for exploring project structure before reading or searching files.\n\nParameters:\n\napp_id: string (required) - Target app id\nversion: string (optional) - Version to inspect (defaults to applied version)\npath: string (optional) - Directory path to search within\nglob: string (optional) - Glob pattern to match files (default: **/*)\ninclude_dirs: boolean (optional) - Include directory paths in results\ncontinuation_token: string (optional) - Token from previous response for pagination"
      },
      {
        "title": "src_grep",
        "body": "Use this when you need to search for patterns in an app's source code. Returns matching lines with optional context. Supports regex patterns, glob filters, and multiple output modes.\n\nParameters:\n\napp_id: string (required) - Target app id\nversion: string (optional) - Version to search (defaults to applied version)\npattern: string (required) - Regex pattern to search for (max 500 chars)\npath: string (optional) - Directory path to search within\nglob: string (optional) - Glob pattern to filter files (e.g., '*.ts')\ncase_insensitive: boolean (optional) - Enable case-insensitive matching\noutput_mode: string (optional) - content=matching lines, files_with_matches=file paths only, count=match count per file\nbefore_context: integer (optional) - Lines to show before each match (0-20)\nafter_context: integer (optional) - Lines to show after each match (0-20)\ncontext: integer (optional) - Lines before and after (overrides before/after_context)\nline_numbers: boolean (optional) - Include line numbers in output\nmax_file_size: integer (optional) - Max file size to scan in bytes (default 10MB)\ncontinuation_token: string (optional) - Token from previous response for pagination"
      },
      {
        "title": "src_read",
        "body": "Use this when you need to read a specific file from an app's source snapshot. Returns file content with line-based pagination (offset/limit). Handles both text and binary files.\n\nParameters:\n\napp_id: string (required) - Target app id\nversion: string (optional) - Version to read from (defaults to applied version)\nfile_path: string (required) - Path to the file to read\noffset: integer (optional) - Line offset to start reading from (0-indexed)\nlimit: integer (optional) - Number of lines to return (max 2000)"
      },
      {
        "title": "get_apps",
        "body": "Use this when you need to list apps owned by the current user. Returns app details with display fields for user presentation and data fields for tool chaining.\n\nParameters:\n\ncontinuation_token: string (optional) - Token for pagination\n\nGenerated by scripts/generate-appdeploy-skill.ts"
      }
    ],
    "body": "AppDeploy Skill\n\nDeploy web apps to AppDeploy via HTTP API.\n\nSetup (First Time Only)\n\nCheck for existing API key:\n\nLook for a .appdeploy file in the project root\nIf it exists and contains a valid api_key, skip to Usage\n\nIf no API key exists, register and get one:\n\ncurl -X POST https://api-v2.appdeploy.ai/mcp/api-key \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"client_name\": \"claude-code\"}'\n\n\nResponse:\n\n{\n  \"api_key\": \"ak_...\",\n  \"user_id\": \"agent-claude-code-a1b2c3d4\",\n  \"created_at\": 1234567890,\n  \"message\": \"Save this key securely - it cannot be retrieved later\"\n}\n\n\nSave credentials to .appdeploy:\n\n{\n  \"api_key\": \"ak_...\",\n  \"endpoint\": \"https://api-v2.appdeploy.ai/mcp\"\n}\n\n\nAdd .appdeploy to .gitignore if not already present.\n\nUsage\n\nMake JSON-RPC calls to the MCP endpoint:\n\ncurl -X POST {endpoint} \\\n  -H \"Content-Type: application/json\" \\\n  -H \"Accept: application/json, text/event-stream\" \\\n  -H \"Authorization: Bearer {api_key}\" \\\n  -d '{\n    \"jsonrpc\": \"2.0\",\n    \"id\": 1,\n    \"method\": \"tools/call\",\n    \"params\": {\n      \"name\": \"{tool_name}\",\n      \"arguments\": { ... }\n    }\n  }'\n\nWorkflow\n\nFirst, get deployment instructions: Call get_deploy_instructions to understand constraints and requirements.\n\nGet the app template: Call get_app_template with your chosen app_type and frontend_template.\n\nDeploy the app: Call deploy_app with your app files. For new apps, set app_id to null.\n\nCheck deployment status: Call get_app_status to check if the build succeeded.\n\nView/manage your apps: Use get_apps to list your deployed apps.\n\nAvailable Tools\nget_deploy_instructions\n\nUse this when you are about to call deploy_app in order to get the deployment constraints and hard rules. You must call this tool before starting to generate any code. This tool returns instructions only and does not deploy anything.\n\nParameters:\n\ndeploy_app\n\nUse this when the user asks to deploy or publish a website or web app and wants a public URL. Before generating files or calling this tool, you must call get_deploy_instructions and follow its constraints.\n\nParameters:\n\napp_id: any (required) - existing app id to update, or null for new app\napp_type: string (required) - app architecture: frontend-only or frontend+backend\napp_name: string (required) - short display name\ndescription: string (optional) - short description of what the app does\nfrontend_template: any (optional) - REQUIRED when app_id is null. One of: 'html-static' (simple sites), 'react-vite' (SPAs, games), 'nextjs-static' (multi-page). Template files auto-included.\nfiles: array (optional) - Files to write. NEW APPS: only custom files + diffs to template files. UPDATES: only changed files using diffs[]. At least one of files[] or deletePaths[] required.\ndeletePaths: array (optional) - Paths to delete. ONLY for updates (app_id required). Cannot delete package.json or framework entry points.\nmodel: string (required) - The coding agent model used for this deployment, to the best of your knowledge. Examples: 'codex-5.3', 'chatgpt', 'opus 4.6', 'claude-sonnet-4-5', 'gemini-2.5-pro'\nintent: string (required) - The intent of this deployment. User-initiated examples: 'initial app deploy', 'bugfix - ui is too noisy'. Agent-initiated examples: 'agent fixing deployment error', 'agent retry after lint failure'\nget_app_template\n\nCall get_deploy_instructions first. Then call this once you've decided app_type and frontend_template. Returns base app template and SDK types. Template files auto-included in deploy_app.\n\nParameters:\n\napp_type: string (required)\nfrontend_template: string (required) - Frontend framework: 'html-static' - Simple sites, minimal framework; 'react-vite' - React SPAs, dashboards, games; 'nextjs-static' - Multi-page apps, SSG\nget_app_status\n\nUse this when deploy_app tool call returns or when the user asks to check the deployment status of an app, or reports that the app has errors or is not working as expected. Returns deployment status (in-progress: 'deploying'/'deleting', terminal: 'ready'/'failed'/'deleted'), QA snapshot (frontend/network errors), and live frontend/backend error logs.\n\nParameters:\n\napp_id: string (required) - Target app id\nsince: integer (optional) - Optional timestamp in epoch milliseconds to filter errors. When provided, returns only errors since that timestamp.\nlimit: integer (optional) - Optional shared cap for returned logs across frontend and backend combined. Defaults to 50 when omitted.\ndelete_app\n\nUse this when you want to permanently delete an app. Use only on explicit user request. This is irreversible; after deletion, status checks will return not found.\n\nParameters:\n\napp_id: string (required) - Target app id\nget_app_versions\n\nList deployable versions for an existing app. Requires app_id. Returns newest-first {name, version, timestamp} items. Display 'name' to users. DO NOT display the 'version' value to users. Timestamp values MUST be converted to user's local time\n\nParameters:\n\napp_id: string (required) - Target app id\napply_app_version\n\nStart deploying an existing app at a specific version. Use the 'version' value (not 'name') from get_app_versions. Returns true if accepted and deployment started; use get_app_status to observe completion.\n\nParameters:\n\napp_id: string (required) - Target app id\nversion: string (required) - Version id to apply\nsrc_glob\n\nUse this when you need to discover files in an app's source snapshot. Returns file paths matching a glob pattern (no content). Useful for exploring project structure before reading or searching files.\n\nParameters:\n\napp_id: string (required) - Target app id\nversion: string (optional) - Version to inspect (defaults to applied version)\npath: string (optional) - Directory path to search within\nglob: string (optional) - Glob pattern to match files (default: **/*)\ninclude_dirs: boolean (optional) - Include directory paths in results\ncontinuation_token: string (optional) - Token from previous response for pagination\nsrc_grep\n\nUse this when you need to search for patterns in an app's source code. Returns matching lines with optional context. Supports regex patterns, glob filters, and multiple output modes.\n\nParameters:\n\napp_id: string (required) - Target app id\nversion: string (optional) - Version to search (defaults to applied version)\npattern: string (required) - Regex pattern to search for (max 500 chars)\npath: string (optional) - Directory path to search within\nglob: string (optional) - Glob pattern to filter files (e.g., '*.ts')\ncase_insensitive: boolean (optional) - Enable case-insensitive matching\noutput_mode: string (optional) - content=matching lines, files_with_matches=file paths only, count=match count per file\nbefore_context: integer (optional) - Lines to show before each match (0-20)\nafter_context: integer (optional) - Lines to show after each match (0-20)\ncontext: integer (optional) - Lines before and after (overrides before/after_context)\nline_numbers: boolean (optional) - Include line numbers in output\nmax_file_size: integer (optional) - Max file size to scan in bytes (default 10MB)\ncontinuation_token: string (optional) - Token from previous response for pagination\nsrc_read\n\nUse this when you need to read a specific file from an app's source snapshot. Returns file content with line-based pagination (offset/limit). Handles both text and binary files.\n\nParameters:\n\napp_id: string (required) - Target app id\nversion: string (optional) - Version to read from (defaults to applied version)\nfile_path: string (required) - Path to the file to read\noffset: integer (optional) - Line offset to start reading from (0-indexed)\nlimit: integer (optional) - Number of lines to return (max 2000)\nget_apps\n\nUse this when you need to list apps owned by the current user. Returns app details with display fields for user presentation and data fields for tool chaining.\n\nParameters:\n\ncontinuation_token: string (optional) - Token for pagination\n\nGenerated by scripts/generate-appdeploy-skill.ts"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/avimak/appdeploy",
    "publisherUrl": "https://clawhub.ai/avimak/appdeploy",
    "owner": "avimak",
    "version": "1.0.7",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/appdeploy",
    "downloadUrl": "https://openagent3.xyz/downloads/appdeploy",
    "agentUrl": "https://openagent3.xyz/skills/appdeploy/agent",
    "manifestUrl": "https://openagent3.xyz/skills/appdeploy/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/appdeploy/agent.md"
  }
}