skiff
skiff 用于创建、维护、安装和发布团队自研的 Agent Skill。Skill 的唯一来源位于
~/.skills/skills/<name>/，安装到各 Agent 时使用软链接。
什么时候使用
- 想把项目里的重复工作沉淀成一个 skill。
- 想完善、校验、转正或发布已有 skill。
- 想把自研 skill 安装到当前项目或全局 Agent。
- 想检查并修复 skill 软链接。
创建一个 skill
skiff create my-skill \
--idea "描述这个 skill 要解决的重复问题" \
--from-project .
命令会在 ~/.skills/.drafts/my-skill/ 创建：
SKILL.md：给 Agent 阅读的工作流与约束。README.md：给人类阅读的用途、准备事项、示例和完成标准。brief.yaml：草稿来源信息，转正时自动移除。
完善 SKILL.md 和 README.md 后运行：
skiff check my-skill
skiff finalize my-skill
提交和发布
只提交：
skiff publish skills/my-skill -m "add my-skill"
提交并推送：
skiff publish skills/my-skill -m "add my-skill" --push
安装
安装到当前项目的 Codex：
skiff add my-skill -a codex -y
安装到全局 Codex：
skiff add my-skill -a codex -g -y
如何判断完成
skiff check <name>输出校验通过。- 正式 skill 同时包含
SKILL.md和README.md。 skiff status或skiff doctor显示目标软链接正常。