getskills/SKILL.md

---
name: getskills
description: OpenClaw 技能管理工具。从 getskills.certer 搜索、下载和更新技能文件。当用户想要搜索、安装、更新或管理 OpenClaw 技能时使用此技能。支持通过 Git 克隆技能仓库、更新已安装的技能、列出本地技能等操作。
license: MIT
---

# GetSkill - OpenClaw 技能管理工具

这是一个用于管理 OpenClaw 技能的命令行工具。它允许你从 getskills.certer API 搜索、下载和更新技能文件。

## 快速安装（复制此部分给 OpenClaw）

如果系统尚未安装 getskill 工具，请执行以下命令：

```bash
# 检查是否已安装
getskill --version

# 如果未安装，执行全局安装
npm install -g @workskills/getskill

# 验证安装成功
getskill --version
```

安装成功后即可使用 `getskill` 命令管理技能。

## 触发条件

当用户提到以下内容时使用此技能：
- 搜索技能 / search skills
- 安装技能 / install skills / download skills
- 更新技能 / update skills
- 列出本地技能 / list local skills
- 管理技能 / manage skills
- getskills / getskill 命令

## 功能特性

### 🔍 搜索技能
从 getskills.certer API 搜索可用的技能，支持关键词搜索。

```bash
getskill search <关键词>
```

### 📥 安装技能
通过 Git 克隆技能仓库到本地缓存目录，并将技能文件复制到 OpenClaw skills 目录。

```bash
getskill install <技能名称>
```

### 🔄 更新技能
通过 Git pull 更新已安装的技能到最新版本。

```bash
getskill update <技能名称>
```

### 📂 列出技能
列出所有已安装的本地技能。

```bash
getskill list
```

### 🛠️ 其他功能

查看目录路径：
```bash
getskill path
```

清理缓存：
```bash
getskill clean
```

配置 API 地址：
```bash
getskill config get
getskill config set <新API地址>
```

## 工作原理

1. **搜索**: 从 `getskills.certer` API 获取技能列表，包含 Git 仓库地址
2. **安装**: 使用 `git clone` 克隆技能仓库到缓存目录 `~/.claude/skills-cache/`
3. **复制**: 将仓库中的 `.md` 技能文件复制到 OpenClaw skills 目录 `~/.claude/skills/`
4. **更新**: 使用 `git pull` 更新仓库，并重新复制文件

## 目录结构

```
~/.claude/
├── skills/          # OpenClaw 技能文件目录
│   ├── skill1.md
│   └── skill2.md
└── skills-cache/    # Git 仓库缓存
    ├── skill1/
    └── skill2/
```

### 平台路径

- **Windows**: `%USERPROFILE%\.claude\skills`
- **macOS**: `~/.claude/skills`
- **Linux**: `~/.claude/skills`

## 安装要求

- Node.js >= 12
- Git 命令行工具（如未安装，程序会自动引导安装）

## 使用示例

### 搜索 commit 相关的技能
```bash
getskill search commit
```

### 安装 commit-helper 技能
```bash
getskill install commit-helper
```

### 更新 commit-helper 技能
```bash
getskill update commit-helper
```

### 列出所有已安装的技能
```bash
getskill list
```

## API 接口规范

### 搜索 API
```
GET https://getskills.certer/repo/search?sort=updated&order=desc&q=<关键词>&page=1&limit=20
```

### 详情 API
```
GET https://getskills.certer/repo/<技能名称>
```

## 编程接口

如果需要在代码中使用，可以通过以下方式：

```javascript
const getskill = require('@workskills/getskill');

// 搜索技能
const results = await getskill.searchSkills('commit');

// 安装技能
const result = await getskill.downloadSkill('skills/commit-helper');

// 更新技能
await getskill.updateSkill('commit-helper');

// 列出本地技能
const skills = getskill.listLocalSkills();
```

## Git 自动检测与安装

首次运行时，程序会自动检测系统是否已安装 Git：

- **Windows**: 自动下载 Git 安装程序并启动安装向导
- **macOS**: 提示使用 Homebrew 安装 Git
- **Linux**: 提示使用系统包管理器安装 Git

## 技能仓库规范

技能 Git 仓库应包含：
- 一个或多个 `.md` 技能文件（非 README）
- 可选的 `README.md` 说明文档
- 可选的示例代码或配置文件

示例结构：
```
commit-helper/
├── commit-helper.md    # 主技能文件（会被复制）
├── README.md           # 说明文档（不会被复制）
└── examples/           # 示例（不会被复制）
```

## 配置自定义 API

可以通过以下方式配置自定义 API 地址：

1. 使用命令行配置：
```bash
getskill config set https://your-custom-api.com
```

2. 使用环境变量：
```bash
GETSKILL_BASE_URL=https://your-custom-api.com getskill search keyword
```

## 注意事项

- 技能文件会被复制到用户的 `~/.claude/skills/` 目录
- Git 仓库缓存保存在 `~/.claude/skills-cache/` 目录
- 只有 `.md` 文件（非 README.md）会被复制到 skills 目录
- 更新技能时会覆盖已存在的技能文件
- 清理缓存不会删除已安装的技能文件，只删除 Git 仓库缓存

## 许可证

MIT

## 作者

workskills.store