从零创建你的第一个 Agent Skill

Skill 是什么？

一个 Skill 就是一个文件夹，核心是 SKILL.md——用 Markdown 告诉 Agent 这个技能是做什么的、怎么用。

步骤 1：创建目录结构

my-first-skill/
├── SKILL.md          # 必需：技能描述和使用说明
├── scripts/          # 可选：脚本文件
│   └── run.sh
└── references/       # 可选：参考文档
    └── api-docs.md

步骤 2：编写 SKILL.md

---
name: my-first-skill
description: 这是一个示例 Skill，教你如何创建自己的 Agent 技能。
---

# My First Skill

## 功能

这个 Skill 可以做以下事情：
- 功能 1
- 功能 2

## 使用方法

直接告诉 Agent 你的需求即可。

## 配置

如果需要 API Key，在这里说明配置方式。

SKILL.md 要点

• 前置元数据：name 和 description 必填
• 使用说明：Agent 会读这段内容来决定如何使用你的 Skill
• 相对路径：引用同目录下的文件用相对路径

步骤 3：本地测试

将 Skill 安装到你的 Agent 目录下，重启 Gateway 测试。

步骤 4：发布到 ClawHub

clawhub publish ./my-first-skill

首次发布需要先登录：

clawhub login

步骤 5：更新版本

修改 Skill 内容后，重新发布即可更新：

clawhub publish ./my-first-skill

最佳实践

1. 描述要具体：Agent 根据描述判断是否使用你的 Skill
2. 示例要丰富：提供典型使用场景和示例命令
3. 脚本要健壮：加错误处理和参数校验
4. 文档要完整：包括前置条件、配置方法、常见问题
5. 避免敏感信息：不要在 SKILL.md 中硬编码 API Key