| name | getskill |
| description | 用于 OpenClaw 的技能管理工具，支持从 getskill.work 仓库搜索、下载和更新技能文件。提供 CLI 和编程接口，通过 API 搜索技能、通过 Git 克隆仓库、将技能目录复制到 OpenClaw skills 目录，并提供 Git 安装引导。 |
| license | MIT |
| compatibility | 需要 Node.js >= 12 和 Git 命令行工具。支持 Windows、macOS 和 Linux 跨平台。 |
| metadata | {"author":"workskills.store","version":"1.1.4","category":"cli-tool"} |
GetSkill
何时使用此 Skill
当你需要以下功能时使用此 skill：
- 从 getskill.work 仓库搜索 OpenClaw 技能
- 向 OpenClaw 环境安装新技能
- 更新现有技能到最新版本
- 管理
~/.openclaw/skills 目录中的技能文件
- 为技能仓库配置自定义 API 端点
指令
OpenClaw 首次启动：先安装 getskill CLI
当 OpenClaw 首次启动且尚未安装 getskill CLI 时，按以下流程执行：
-
先测试 getskill 是否可用：
getskill --help
-
如果不可用，安装 CLI（任选其一）：
pnpm i -g @workskills/getskill
或
npm i -g @workskills/getskill
-
安装完成后即可运行 getskill 命令：
getskill search <关键词>
搜索技能
-
使用搜索命令并传入关键词：
getskill search <关键词>
-
工具查询 API 并返回匹配的技能，包含：
安装技能
-
首先确保系统已安装 Git（如未安装，工具会引导安装）
-
运行安装命令：
getskill install <技能名称>
-
工具执行以下操作：
- 克隆 Git 仓库到
~/.openclaw/skills-cache/<技能名称>
- 将整个技能目录复制到
~/.openclaw/skills/<本地技能目录名>（排除 .git）
- 返回已复制目录列表
更新技能
-
运行更新命令：
getskill update <技能名称>
-
工具会：
- 检查技能是否存在于缓存目录
- 执行
git pull 获取最新变更
- 重新复制技能目录到 skills 目录
列出本地技能
getskill list
返回 skills 目录中当前所有技能目录名称。
查看目录路径
getskill path
显示：
- 技能目录：
~/.openclaw/skills
- 缓存目录：
~/.openclaw/skills-cache
配置 API 端点
查看当前端点：
getskill config get
设置自定义端点：
getskill config set https://your-custom-api.com
清理缓存
getskill clean
移除所有 Git 仓库缓存，不影响已安装的技能。
示例
搜索示例
输入： 用户想查找与 commit 相关的技能
命令：
getskill search commit
输出：
找到 3 个技能：
1. commit-helper
描述: 帮助生成规范的 git commit 信息
Git: https://getskill.work/skills/commit-helper.git
安装示例
输入： 用户想安装 commit-helper 技能
命令：
getskill install commit-helper
操作：
git clone 到 ~/.openclaw/skills-cache/commit-helper- 复制整个目录到
~/.openclaw/skills/commit-helper
输出：
技能已安装到 skills 目录:
- ~/.openclaw/skills/commit-helper
更新示例
输入： 用户想更新已有技能
命令：
getskill update commit-helper
操作：
cd ~/.openclaw/skills-cache/commit-helpergit pull- 重新复制技能目录到 skills 目录
边缘情况
Git 未安装
场景： 用户在没有 Git 的系统上运行 install/update 命令
处理：
- Windows：自动下载 Git 安装程序并启动安装向导
- macOS：提示通过 Homebrew 安装（
brew install git）
- Linux：提供包管理器命令（apt-get、yum、dnf、pacman）
技能未找到
场景： API 返回 404 表示请求的技能不存在
处理： 显示清晰的错误信息："技能不存在: {skill-name}"
仓库无技能文件
场景： 克隆的仓库中不包含技能 .md 文件（除 README 外）
处理： 抛出错误："在仓库中未找到技能 .md 文件"
网络错误
场景： 由于网络问题导致 API 请求失败
处理：
- 主机未找到："无法连接到服务器，请检查网络或 API 地址配置"
- 超时："请求超时，请稍后重试"
- 连接被拒绝："服务器拒绝连接，请检查 API 地址是否正确"
技能名称重复
场景： 仓库中有多个名称相似的 .md 文件
处理： 将技能目录整体复制到 skills 目录（排除 .git）
关键规则
- 在执行 clone/pull 操作前始终验证 Git 安装
- 复制整个技能目录到
skills/<技能名>，并排除 .git 目录
- 清理时绝不删除 skills 目录内容 - 只移除缓存
- 支持通过环境变量
GETSKILL_BASE_URL 使用自定义端点
- 自动处理 API 重定向（最多 5 次）
- API 请求 60 秒后超时
- 如果目录不存在则递归创建
- 搜索失败时返回空数组（而不是抛出异常）以防止程序崩溃
- 在调用 API 前验证所有用户输入
