feat: 初始化 getskills 技能

添加 SKILL.md 文件,将 getskills 工具转换为标准技能格式

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
This commit is contained in:
2026-03-22 22:46:32 +08:00
commit 4bbdbfd52e
27 changed files with 2285 additions and 0 deletions

204
SKILL.md Normal file
View File

@@ -0,0 +1,204 @@
---
name: getskills
description: OpenClaw 技能管理工具。从 getskills.certer 搜索、下载和更新技能文件。当用户想要搜索、安装、更新或管理 OpenClaw 技能时使用此技能。支持通过 Git 克隆技能仓库、更新已安装的技能、列出本地技能等操作。
license: MIT
---
# GetSkill - OpenClaw 技能管理工具
这是一个用于管理 OpenClaw 技能的命令行工具。它允许你从 getskills.certer API 搜索、下载和更新技能文件。
## 触发条件
当用户提到以下内容时使用此技能:
- 搜索技能 / 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