.pouch/skills/skiff/SKILL.md

name, description

name	description
skiff	维护 ~/.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. 提交并推送（不用离开当前目录）

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

只暂存不提交：

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

3. 装到项目或全局

# 当前项目
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. 卸载

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

5. 浏览可用自研 skill

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 版本