---
name: skiff
description: >-
  维护 ~/.skills 自研 skill：编辑后用 skiff publish 提交推送，用 skiff add/remove 在各项目或全局挂卸 skill。
  触发词：skiff、自研 skill、publish skill、安装自研 skill、更新 skill 到项目。
---

# skiff 自研 Skill 工作流

SSOT 固定在 `~/.skills/skills/<name>/`。内容通过 **symlink** 分发到各 agent，改 SSOT 即全项目生效。

---

## 日常流程

### 1. 改 skill

直接编辑：

```
~/.skills/skills/<name>/SKILL.md
```

### 2. 提交并推送（不用离开当前目录）

```bash
skiff publish skills/<name> -m "update <name>" --push
```

只暂存不提交：

```bash
skiff publish skills/<name> --no-commit
```

### 3. 装到项目或全局

```bash
# 当前项目
cd ~/code/my-app
skiff add discussion-notes -a cursor -y

# 全局（所有项目）
skiff add discussion-notes -a cursor -g -y

# 多个 agent
skiff add discussion-notes -a cursor -a codex -g -y
```

### 4. 卸载

```bash
skiff remove discussion-notes -a cursor -y          # 当前项目
skiff remove discussion-notes -g -a cursor -y     # 全局
skiff rm discussion-notes -g -y                     # rm 别名
```

### 5. 浏览可用自研 skill

```bash
skiff add --list
```

---

## 与 Vercel `npx skills` 的分工

| 场景 | 工具 |
|------|------|
| 自研 skill（~/.skills） | **skiff** |
| 社区 skill（GitHub 任意仓库） | `npx skills add` |

---

## 命令对照

| skiff | 说明 |
|-------|------|
| `add <name> [-g] [-a AGENT...] [-y]` | 安装 |
| `remove <name> [-g] [-a AGENT...] [-y]` | 卸载（`rm` / `r` 别名） |
| `add --list` | 列出可用自研 skill |
| `publish [paths] -m MSG [--push]` | git add / commit / push |
| `list` | 列出 ~/.skills 目录结构 |
| `status` | 查看软链安装状态 |
| `create <name>` | 新建自研 skill |

---

## 注意

- 不要在 `project/.agents/skills/` 里直接改文件；应改 `~/.skills/skills/` 再 `publish`
- symlink 正确时，**不需要 reinstall**；保存 SSOT 后各项目自动读到新内容
- 社区 skill 用 `npx skills add`，不要用 skiff `registry add` 除非团队要 pin 版本