Back to Details

byted-skillhub-download

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

byted-skillhub-download

byted-skillhub-download

用途
  • 从 SkillHub 精确按名称定位并下载私有或企业专属技能的最新版本 zip 包。
  • 默认自动解压：下载后会自动解压至以技能名称命名的目录中，并平铺顶层目录结构。
  • 下载并解压完成后输出目录路径。
何时调用
  • 当用户需求涉及下载私有技能或企业专属技能时触发。常见语义包括：
    1. 明确要求从 
      byted-skillhub-download
      下载。
    2. 提到“下载企业专属技能”、“下载内部技能”或“下载私有 skill/技能”。
    3. 需要拉取存储在公司/企业 SkillHub 空间内的特定私有资源包。
  • 注意：对于普通的公开技能（Public Skills），请优先使用其他公开下载能力。
环境说明 (Agent 必读)
  • 无需向用户索要环境变量：当前环境已自动注入以下变量： 
    • ARK_SKILL_API_BASE
      : SkillHub API 服务地址
    • ARK_SKILL_API_KEY
      : 企业 SkillHub 访问密钥
    • SKILLHUB_SKILL_SPACE_ID
      : 企业专属技能空间 ID
  • 严禁向用户询问参数值：Agent 在触发此技能时，应直接从环境中读取这些变量并执行脚本，不得中断流程向用户确认这些信息。
下载步骤
  1. 执行脚本（路径相对于本 SKILL.md 所在目录） 
    • python ./scripts/download_from_skillhub.py --name "<精确名称>" --output /root/.openclaw/workspace/skills/
    • 默认会将技能解压到 
      /root/.openclaw/workspace/skills/<skill_name>/
      目录下
    • 若只想下载 zip 包而不解压，请添加 
      --no-extract
      参数
  2. 观察输出
    • 成功时，最后一行将打印解压后的目录路径（或 zip 文件路径）
安装提示
  • 本技能仅下载并解压，不负责后续的安装逻辑。
示例
  • 下载名为 "awesome-tool" 的技能至默认目录 
    • python ./scripts/download_from_skillhub.py --name "awesome-tool" --output /root/.openclaw/workspace/skills/
故障排查
  • 如提示缺少环境变量，请确认在环境中运行或联系管理员
  • 未找到技能：确认名称为精确匹配，或检查 SkillSpaceId 是否正确
  • 网络或鉴权错误：检查网络连通性与 API Key 是否有效
Purpose
  • Precisely locate and download the latest version zip package of private or enterprise-exclusive skills from SkillHub by name.
  • Auto-extraction by default: After downloading, it will automatically extract to a directory named after the skill and flatten the top-level directory structure.
  • Output the directory path after downloading and extraction are completed.
When to Call
  • Triggered when the user's request involves downloading private skills or enterprise-exclusive skills. Common semantics include:
    1. Explicitly requesting to download from 
      byted-skillhub-download
      .
    2. Mentioning "download enterprise-exclusive skills", "download internal skills", or "download private skill/skills".
    3. Needing to pull specific private resource packages stored in the company/enterprise SkillHub space.
  • Note: For ordinary public skills (Public Skills), please prioritize using other public download capabilities.
Environment Instructions (Required for Agents)
  • No need to ask users for environment variables: The following variables are automatically injected into the current environment: 
    • ARK_SKILL_API_BASE
      : SkillHub API service address
    • ARK_SKILL_API_KEY
      : Enterprise SkillHub access key
    • SKILLHUB_SKILL_SPACE_ID
      : Enterprise-exclusive skill space ID
  • Strictly prohibited to ask users for parameter values: When triggering this skill, the Agent should directly read these variables from the environment and execute the script, and must not interrupt the process to confirm this information with the user.
Download Steps
  1. Execute the script (path relative to the directory where this SKILL.md is located) 
    • python ./scripts/download_from_skillhub.py --name "<exact name>" --output /root/.openclaw/workspace/skills/
    • By default, the skill will be extracted to the 
      /root/.openclaw/workspace/skills/<skill_name>/
      directory
    • If you only want to download the zip package without extraction, add the 
      --no-extract
      parameter
  2. Observe the output
    • On success, the last line will print the extracted directory path (or zip file path)
Installation Notes
  • This skill only downloads and extracts, and is not responsible for subsequent installation logic.
Examples
  • Download the skill named "awesome-tool" to the default directory 
    • python ./scripts/download_from_skillhub.py --name "awesome-tool" --output /root/.openclaw/workspace/skills/
Troubleshooting
  • If prompted for missing environment variables, confirm you are running in the environment or contact the administrator
  • Skill not found: Confirm the name is an exact match, or check if the SkillSpaceId is correct
  • Network or authentication errors: Check network connectivity and whether the API Key is valid