\r \r

GetSkill\r

\r

何时使用此 Skill\r

\r 当你需要以下功能时使用此 skill：\r

• 从 getskill.work 仓库搜索 OpenClaw 技能\r
• 向 OpenClaw 环境安装新技能\r
• 更新现有技能到最新版本\r
• 管理 ~/.openclaw/skills 目录中的技能文件\r
• 为技能仓库配置自定义 API 端点\r \r

指令\r

\r

OpenClaw 首次启动：先安装 getskill CLI\r

\r 当 OpenClaw 首次启动且尚未安装 getskill CLI 时，按以下流程执行：\r \r

1. 先测试 getskill 是否可用：\r

   getskill --help\r
   ```\r
   

\r 2. 如果不可用，安装 CLI（任选其一）：\r

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