跳到主要内容

4.1 技能分享

把你写好的 SKILL.md 让其他人用上,是技能生态循环的核心。本节描述三种分享路径。SKILL.md 的字段定义与工作机制在 3.11.1 SKILL.md 文件结构 中已详细讲过,本节不重复。

三种分享路径

路径适用场景影响范围
提交到 ClawHub社区公开分享任何人在 Studio 技能工坊 → ClawHub 社区 搜索可发现
Git / GitHub 托管团队私有、迭代频繁只有拿到仓库或文件 URL 的人能用
直接发文件一次性非正式分享收件人手动放到自己的 skills/ 目录

选择建议:团队私有用 Git,对社区有普遍价值的用 ClawHub,临时分享用直接发文件。

路径 1:提交到 ClawHub

适用于经过验证、对社区有普遍价值的技能。

  1. 技能工坊 → 已安装 选择你的技能 → 右键 分享到 ClawHub
  2. 填写公开发布信息:维护者、license、tags、版本说明
  3. 提交审核
  4. 审核通过后任何人在 ClawHub 社区 搜索都能看到

提交前务必确认:

  • SKILL.md 的 description 准确(其他人靠它判断要不要装)
  • trigger 关键词覆盖典型场景
  • risk 不要低估,宁可保守
  • 不含敏感信息(API Key、内部链接、个人凭据)

路径 2:Git / GitHub 托管

适用于团队私有或需要频繁迭代的技能。

  1. skills/<name>/SKILL.md 放进任意 git 仓库(私有或公开)
  2. 把仓库 URL、Release、或 raw 文件 URL 发给需要的人
  3. 对方在 Studio 技能工坊 → 从 URL 导入 输入这个 URL → 一键安装

这是"链接式分享":

  • 不依赖对话软件,URL 本身就是分享单位
  • 同一个 URL 永远指向最新版本(Git 主分支)
  • 用 Release tag 可以指向固定版本,避免主分支变更影响已使用技能的用户

路径 3:直接发文件

适用于一次性的非正式分享。

  1. skills/<name>/SKILL.md 文件本体发给收件人(IM、邮件、网盘)
  2. 对方把文件保存到自己 Studio 工作区的 skills/<name>/SKILL.md
  3. Studio 自动扫描发现,无需重启

写出好技能的建议

建议解释
先写 description 再写正文想清楚"AI 在什么场景会用它",才能写对应的步骤
trigger 不要太宽泛不要写 trigger: 摄像头——会跟所有摄像头话题冲突;用 trigger: USB摄像头黑屏,hobot_usb_cam,code -6 等具体场景
正文用步骤化1. 2. 3. 而不是大段散文,AI 解析更稳定
附完整命令别写"看一下进程",写 ps aux | grep ros 等完整命令
加反例"以下做法不要做"往往比"应该这样做"更有教育意义
维护 version 字段便于使用者判断是否需要更新
在 README 中附效果说明帮助潜在使用者快速判断是否适合自己的场景