{
  "schemaVersion": "1.0",
  "item": {
    "slug": "skillinstall",
    "name": "skill_install",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/otho2966-ai/skillinstall",
    "canonicalUrl": "https://clawhub.ai/otho2966-ai/skillinstall",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/skillinstall",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=skillinstall",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "_meta.json",
      "scripts/skill_install.py"
    ],
    "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. Then review README.md for any prerequisites, environment setup, or post-install checks. 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. Then review README.md for any prerequisites, environment setup, or post-install checks. 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/skillinstall"
    },
    "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/skillinstall",
    "agentPageUrl": "https://openagent3.xyz/skills/skillinstall/agent",
    "manifestUrl": "https://openagent3.xyz/skills/skillinstall/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/skillinstall/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. Then review README.md for any prerequisites, environment setup, or post-install checks. 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. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Skill Installer",
        "body": "Install OpenClaw skills from clawhub.ai ZIP files with automatic detection, validation, and Gateway updates."
      },
      {
        "title": "Features",
        "body": "Automatic Detection: Finds OpenClaw installation location automatically\nFile Search: Search for ZIP files in current directory when filename is not specified\nDuplicate Check: Verifies if a skill is already installed before proceeding\nInteractive Selection: Prompts user to choose when multiple matching files are found\nValidation: Validates skill structure (SKILL.md, _meta.json)\nGateway Update: Automatically restarts Gateway to make new skills available\nProgress Feedback: Detailed status messages throughout the installation process"
      },
      {
        "title": "Basic Installation",
        "body": "# Install from a specific ZIP file\npython3 scripts/skill_install.py my-skill.zip\n\n# Search for ZIP files in current directory\npython3 scripts/skill_install.py\n\n# List all installed skills\npython3 scripts/skill_install.py --list\n\n# Show help\npython3 scripts/skill_install.py --help"
      },
      {
        "title": "Workflow",
        "body": "File Detection:\n\nIf filename is provided: Use that file directly\nIf no filename: Search for *.zip files in current directory\nIf multiple files found: Display list and ask user to choose\n\n\n\nValidation:\n\nCheck if OpenClaw is installed\nValidate ZIP file structure\nVerify SKILL.md and _meta.json exist\n\n\n\nDuplicate Check:\n\nExtract skill name from SKILL.md\nCheck if skill already exists in skills directory\nPrompt for confirmation if duplicate found\n\n\n\nInstallation:\n\nExtract ZIP file to skills directory\nVerify extracted files\nRestart OpenClaw Gateway\n\n\n\nCompletion:\n\nDisplay success message\nShow skill path\nConfirm Gateway restart"
      },
      {
        "title": "File Structure",
        "body": "The script expects skills to have the following structure:\n\nskill-name.zip\n├── SKILL.md          # Required: Skill metadata and documentation\n├── _meta.json        # Required: Additional metadata\n├── scripts/          # Optional: Python/Node scripts\n│   └── *.py/*.mjs\n├── references/       # Optional: Reference documentation\n└── README.md         # Optional: Extended documentation"
      },
      {
        "title": "Install from Current Directory",
        "body": "# List all ZIP files in current directory\npython3 scripts/skill_install.py\n\n# Output:\n# Found 3 ZIP files:\n# 1. github-skill.zip\n# 2. weather-skill.zip\n# 3. notion-skill.zip\n#\n# Select a file (1-3) or 'q' to quit: 1\n#\n# Installing: github-skill.zip\n# ..."
      },
      {
        "title": "Install Specific File",
        "body": "python3 scripts/skill_install.py github-skill.zip\n\n# Output:\n# ============================================================\n# 📦 OpenClaw Skill Installer\n# ============================================================\n#\n# 🔍 正在搜索 OpenClaw 安装位置...\n# ✅ 找到 OpenClaw: /home/user/.nvm/versions/node/v22.22.0/lib/node_modules/openclaw\n#\n# 📂 正在解析 ZIP 文件...\n# ✅ 找到 SKILL.md\n# ✅ Skill 名称: github\n# ✅ Skill 描述: GitHub operations via gh CLI\n#\n# 🔍 检查是否已安装...\n# ℹ️  Skill 'github' 未安装\n#\n# 📦 正在安装 skill...\n# ✅ 安装成功！\n#\n# 🔄 正在重启 Gateway...\n# ✅ Gateway 已重启\n#\n# 🎉 安装完成！\n# Skill 路径: /home/user/.nvm/versions/node/v22.22.0/lib/node_modules/openclaw/skills/github\n#\n# 现在可以在 OpenClaw 中使用 'github' skill 了！"
      },
      {
        "title": "List Installed Skills",
        "body": "python3 scripts/skill_install.py --list\n\n# Output:\n# ============================================================\n# 📋 已安装的 Skills\n# ============================================================\n#\n# 1. github\n#    📁 文件夹: github\n#    📝 描述: GitHub operations via gh CLI\n#    📍 路径: /home/user/.nvm/versions/node/v22.22.0/lib/node_modules/openclaw/skills/github\n#\n# 2. weather\n#    📁 文件夹: weather\n#    📝 描述: Get current weather and forecasts\n#    📍 路径: /home/user/.nvm/versions/node/v22.22.0/lib/node_modules/openclaw/skills/weather\n#\n# ..."
      },
      {
        "title": "Requirements",
        "body": "Python 3.6 or higher\nOpenClaw installed (via npm or nvm)\nSufficient permissions to write to OpenClaw skills directory"
      },
      {
        "title": "Common Errors",
        "body": "Error: ❌ 未找到 OpenClaw 安装位置\n\nSolution: Install OpenClaw first using npm install -g openclaw\n\nError: ❌ ZIP 文件不存在\n\nSolution: Check the filename and path\n\nError: ❌ ZIP 文件不包含 SKILL.md\n\nSolution: Ensure the ZIP file is a valid skill from clawhub.ai\n\nError: ⚠️  Skill 已存在\n\nSolution: Confirm if you want to overwrite or use a different skill\n\nError: ❌ Gateway 重启失败\n\nSolution: Manually restart Gateway using openclaw daemon restart"
      },
      {
        "title": "Custom OpenClaw Path",
        "body": "If the script cannot find OpenClaw automatically, you can modify the OPENCLAW_PATH variable in the script:\n\nOPENCLAW_PATH = \"/custom/path/to/openclaw\""
      },
      {
        "title": "Skip Gateway Restart",
        "body": "To restart Gateway manually, comment out the restart call:\n\n# restart_gateway(openclaw_root)"
      },
      {
        "title": "Permission Denied",
        "body": "If you encounter permission errors:\n\n# Fix permissions\nchmod 755 ~/.nvm/versions/node/*/lib/node_modules/openclaw/skills"
      },
      {
        "title": "Skill Not Appearing in OpenClaw",
        "body": "After installation, if the skill doesn't appear:\n\nRestart Gateway manually:\nopenclaw daemon restart\n\n\n\nCheck OpenClaw logs:\nopenclaw logs --follow\n\n\n\nVerify skill structure:\nls -la ~/.nvm/versions/node/*/lib/node_modules/openclaw/skills/your-skill/"
      },
      {
        "title": "Version 1.0.0 (2025-02-26)",
        "body": "Initial Release\n\nFeatures:\n\nAutomatic OpenClaw detection\nZIP file installation from clawhub.ai\nFile search and interactive selection\nDuplicate checking\nGateway auto-restart\nProgress feedback\nList installed skills command\n\nEnhancements:\n\nSupport for multiple ZIP file selection\nDetailed error messages\nSkill validation (SKILL.md, _meta.json)\nCross-platform compatibility (Linux, macOS, Windows)\n\nBug Fixes:\n\nFixed path resolution on different Node.js installations\nImproved ZIP extraction handling\nBetter error recovery\n\nKnown Issues:\n\nMay require manual Gateway restart on some systems\nLimited to single skill installation per run"
      },
      {
        "title": "Notes",
        "body": "The script searches for OpenClaw in common locations:\n\n~/.nvm/versions/node/*/lib/node_modules/openclaw\n/usr/local/lib/node_modules/openclaw\n/opt/node_modules/openclaw\n\n\n\nSkills are installed to:\n\n<OpenClaw Root>/skills/<skill-name>/\n\n\n\nGateway restart requires systemd support (Linux) or manual restart (other platforms)\n\n\nFor development or testing, use --list to verify skills before installation"
      }
    ],
    "body": "Skill Installer\n\nInstall OpenClaw skills from clawhub.ai ZIP files with automatic detection, validation, and Gateway updates.\n\nFeatures\nAutomatic Detection: Finds OpenClaw installation location automatically\nFile Search: Search for ZIP files in current directory when filename is not specified\nDuplicate Check: Verifies if a skill is already installed before proceeding\nInteractive Selection: Prompts user to choose when multiple matching files are found\nValidation: Validates skill structure (SKILL.md, _meta.json)\nGateway Update: Automatically restarts Gateway to make new skills available\nProgress Feedback: Detailed status messages throughout the installation process\nUsage\nBasic Installation\n# Install from a specific ZIP file\npython3 scripts/skill_install.py my-skill.zip\n\n# Search for ZIP files in current directory\npython3 scripts/skill_install.py\n\n# List all installed skills\npython3 scripts/skill_install.py --list\n\n# Show help\npython3 scripts/skill_install.py --help\n\nWorkflow\n\nFile Detection:\n\nIf filename is provided: Use that file directly\nIf no filename: Search for *.zip files in current directory\nIf multiple files found: Display list and ask user to choose\n\nValidation:\n\nCheck if OpenClaw is installed\nValidate ZIP file structure\nVerify SKILL.md and _meta.json exist\n\nDuplicate Check:\n\nExtract skill name from SKILL.md\nCheck if skill already exists in skills directory\nPrompt for confirmation if duplicate found\n\nInstallation:\n\nExtract ZIP file to skills directory\nVerify extracted files\nRestart OpenClaw Gateway\n\nCompletion:\n\nDisplay success message\nShow skill path\nConfirm Gateway restart\nFile Structure\n\nThe script expects skills to have the following structure:\n\nskill-name.zip\n├── SKILL.md          # Required: Skill metadata and documentation\n├── _meta.json        # Required: Additional metadata\n├── scripts/          # Optional: Python/Node scripts\n│   └── *.py/*.mjs\n├── references/       # Optional: Reference documentation\n└── README.md         # Optional: Extended documentation\n\nExamples\nInstall from Current Directory\n# List all ZIP files in current directory\npython3 scripts/skill_install.py\n\n# Output:\n# Found 3 ZIP files:\n# 1. github-skill.zip\n# 2. weather-skill.zip\n# 3. notion-skill.zip\n#\n# Select a file (1-3) or 'q' to quit: 1\n#\n# Installing: github-skill.zip\n# ...\n\nInstall Specific File\npython3 scripts/skill_install.py github-skill.zip\n\n# Output:\n# ============================================================\n# 📦 OpenClaw Skill Installer\n# ============================================================\n#\n# 🔍 正在搜索 OpenClaw 安装位置...\n# ✅ 找到 OpenClaw: /home/user/.nvm/versions/node/v22.22.0/lib/node_modules/openclaw\n#\n# 📂 正在解析 ZIP 文件...\n# ✅ 找到 SKILL.md\n# ✅ Skill 名称: github\n# ✅ Skill 描述: GitHub operations via gh CLI\n#\n# 🔍 检查是否已安装...\n# ℹ️  Skill 'github' 未安装\n#\n# 📦 正在安装 skill...\n# ✅ 安装成功！\n#\n# 🔄 正在重启 Gateway...\n# ✅ Gateway 已重启\n#\n# 🎉 安装完成！\n# Skill 路径: /home/user/.nvm/versions/node/v22.22.0/lib/node_modules/openclaw/skills/github\n#\n# 现在可以在 OpenClaw 中使用 'github' skill 了！\n\nList Installed Skills\npython3 scripts/skill_install.py --list\n\n# Output:\n# ============================================================\n# 📋 已安装的 Skills\n# ============================================================\n#\n# 1. github\n#    📁 文件夹: github\n#    📝 描述: GitHub operations via gh CLI\n#    📍 路径: /home/user/.nvm/versions/node/v22.22.0/lib/node_modules/openclaw/skills/github\n#\n# 2. weather\n#    📁 文件夹: weather\n#    📝 描述: Get current weather and forecasts\n#    📍 路径: /home/user/.nvm/versions/node/v22.22.0/lib/node_modules/openclaw/skills/weather\n#\n# ...\n\nRequirements\nPython 3.6 or higher\nOpenClaw installed (via npm or nvm)\nSufficient permissions to write to OpenClaw skills directory\nError Handling\nCommon Errors\n\nError: ❌ 未找到 OpenClaw 安装位置\n\nSolution: Install OpenClaw first using npm install -g openclaw\n\nError: ❌ ZIP 文件不存在\n\nSolution: Check the filename and path\n\nError: ❌ ZIP 文件不包含 SKILL.md\n\nSolution: Ensure the ZIP file is a valid skill from clawhub.ai\n\nError: ⚠️ Skill 已存在\n\nSolution: Confirm if you want to overwrite or use a different skill\n\nError: ❌ Gateway 重启失败\n\nSolution: Manually restart Gateway using openclaw daemon restart\nAdvanced Usage\nCustom OpenClaw Path\n\nIf the script cannot find OpenClaw automatically, you can modify the OPENCLAW_PATH variable in the script:\n\nOPENCLAW_PATH = \"/custom/path/to/openclaw\"\n\nSkip Gateway Restart\n\nTo restart Gateway manually, comment out the restart call:\n\n# restart_gateway(openclaw_root)\n\nTroubleshooting\nPermission Denied\n\nIf you encounter permission errors:\n\n# Fix permissions\nchmod 755 ~/.nvm/versions/node/*/lib/node_modules/openclaw/skills\n\nSkill Not Appearing in OpenClaw\n\nAfter installation, if the skill doesn't appear:\n\nRestart Gateway manually:\n\nopenclaw daemon restart\n\n\nCheck OpenClaw logs:\n\nopenclaw logs --follow\n\n\nVerify skill structure:\n\nls -la ~/.nvm/versions/node/*/lib/node_modules/openclaw/skills/your-skill/\n\nChangelog\nVersion 1.0.0 (2025-02-26)\n\nInitial Release\n\nFeatures:\n\nAutomatic OpenClaw detection\nZIP file installation from clawhub.ai\nFile search and interactive selection\nDuplicate checking\nGateway auto-restart\nProgress feedback\nList installed skills command\n\nEnhancements:\n\nSupport for multiple ZIP file selection\nDetailed error messages\nSkill validation (SKILL.md, _meta.json)\nCross-platform compatibility (Linux, macOS, Windows)\n\nBug Fixes:\n\nFixed path resolution on different Node.js installations\nImproved ZIP extraction handling\nBetter error recovery\n\nKnown Issues:\n\nMay require manual Gateway restart on some systems\nLimited to single skill installation per run\nNotes\n\nThe script searches for OpenClaw in common locations:\n\n~/.nvm/versions/node/*/lib/node_modules/openclaw\n/usr/local/lib/node_modules/openclaw\n/opt/node_modules/openclaw\n\nSkills are installed to:\n\n<OpenClaw Root>/skills/<skill-name>/\n\nGateway restart requires systemd support (Linux) or manual restart (other platforms)\n\nFor development or testing, use --list to verify skills before installation"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/otho2966-ai/skillinstall",
    "publisherUrl": "https://clawhub.ai/otho2966-ai/skillinstall",
    "owner": "otho2966-ai",
    "version": "1.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/skillinstall",
    "downloadUrl": "https://openagent3.xyz/downloads/skillinstall",
    "agentUrl": "https://openagent3.xyz/skills/skillinstall/agent",
    "manifestUrl": "https://openagent3.xyz/skills/skillinstall/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/skillinstall/agent.md"
  }
}