创建与发布技能
构建自己的技能并分享到技能市集
任何拥有 Claw Buff 账户的人都可以在技能市集上创建和发布技能。
创建技能
编辑器
技能编辑器有两个面板：
左侧面板 — SKILL.md 内容：
用 Markdown 编写技能指令。这是技能的核心——教会智能体如何执行任务的提示词文档。你还可以上传可选的脚本文件（JS/TS）用于高级行为。
右侧面板 — 元数据：
| 字段 | 必填 | 描述 |
|---|---|---|
| 名称 | 是 | 显示名称（最少 2 个字符） |
| 描述 | 是 | 卡片上显示的简短摘要 |
| 分类 | 是 | 开发、生产力、通信等 |
| 标签 | 否 | 逗号分隔的发现标签 |
| 版本 | 是 | 语义化版本（如 1.0.0） |
编写好的 SKILL.md
技能的质量完全取决于指令的清晰度。遵循以下结构：
---
name: my-skill
description: 一句话描述这个技能做什么
version: 1.0.0
---
# My Skill
## 概述
简要说明智能体使用此技能能做什么。
## 命令 / 工作流
智能体应遵循的分步指令。
明确指定使用哪些工具以及顺序。
## 示例
展示具体的输入/输出示例，
让智能体理解预期行为。
## 限制
此技能不能做什么或不应尝试什么。最好的技能是专注且具体的。一个做好一件事的技能比试图覆盖所有的更有用。想"GitHub PR 审查器"而不是"通用代码助手"。
保存与发布
你有两个选项：
- 保存草稿 — 保存但不发布。只有你能看到草稿。适用于进行中的技能。
- 发布 — 提交技能进行审核，审核通过后在市集上线。
审核流程
发布技能时，会发生以下步骤：
- 自动安全扫描 — 脚本文件（如有）会被扫描已知恶意模式（反向 shell、数据外泄、凭证窃取）。
- 审核状态 — 通过扫描的含脚本技能设为"待审核"。不含脚本的技能（仅 SKILL.md）自动通过。
- 通知 — 技能被批准或拒绝时你会收到通知。被拒绝的技能包含审核说明。
仅包含 SKILL.md（无脚本文件）的技能会自动通过，因为它们是纯提示词文档，没有可执行代码。添加脚本会触发安全审核流程。
管理你的技能
我的技能
在市集页面点击我的技能标签查看所有技能及其状态：
| 状态 | 含义 |
|---|---|
| 已发布（绿色） | 在市集上线，所有人可见 |
| 待审核（橙色） | 已提交，等待审批 |
| 已拒绝（红色） | 被拒绝并附有审核说明——编辑后重新提交 |
| 未发布（灰色） | 草稿或手动取消发布 |
编辑
点击你的任何技能在编辑器中打开。你可以更新：
- SKILL.md 内容
- 元数据（名称、描述、分类、标签）
- 版本号
- 脚本文件
对已发布技能的更改保存后立即生效。
取消发布
要暂时从市集下架技能而不删除它：
- 在编辑器中打开技能
- 在危险区域点击取消发布
技能变为草稿。你可以随时重新发布。
删除
要永久删除技能：
- 在编辑器中打开技能
- 在危险区域点击删除
- 确认删除
删除是永久性的，无法撤销。如果用户已安装你的技能，已安装的副本会保留在他们的智能体上，但不会再有后续更新。
最佳实践
- 指令要具体。 "帮用户使用 GitHub"太模糊。"使用
gh pr create创建包含已暂存更改的 Pull Request"才是可操作的。 - 包含示例。 展示好的输入和输出。这能大幅提高技能的可靠性。
- 声明依赖。 如果技能需要 API 密钥或二进制文件，在 SKILL.md 的 frontmatter 和描述中清楚说明。
- 有意义地版本化。 做出更改时递增版本号。用户和平台会跟踪版本历史。
- 发布前测试。 在自己的智能体上安装技能，验证其按预期工作后再公开。
- 写清楚描述。 这是用户最先看到的。要具体——这个技能到底能为他们的智能体做什么？