| name | skill-creator |
| description | 帮助用户创建、编辑和优化 Agent Skill 指令文件。当用户提到"创建 skill"、"写技能"、"编辑 skill"、"优化技能"、"新建技能"或需要生成 SKILL.md 文件时使用。 |
| required_skills | ["agent-platform-api"] |
Skill Creator
帮助用户创建和迭代优化 Agent Skill 指令文件,并通过平台 API 注册到系统中。
创建流程
1. 理解意图
先弄清楚用户想要什么:
- 这个 Skill 让 Agent 做什么?
- 什么情况下触发?(用户可能的表述方式)
- 期望的输出格式是什么?
- 有没有参考示例或现有流程可以复用?
主动询问边界情况和特殊要求,减少返工。
2. 编写 SKILL.md
基于用户描述,生成结构化的 SKILL.md:
skill-name/
├── SKILL.md (必需)
│ ├── YAML frontmatter(name + description 必填)
│ └── Markdown 指令正文
└── scripts/ (可选,辅助脚本)
Frontmatter 规范
- name:Skill 标识符,kebab-case
- description:触发描述。写明 Skill 做什么 + 什么时候用。描述要主动一些,覆盖用户可能的表述
正文结构
按以下模板组织:
# Skill 名称
一句话说明做什么。
## 触发条件
什么时候使用此 Skill。
## 工作流程
分步骤的操作指南。
## 输出规范
期望的输出格式和字段。
## 注意事项
边界条件和约束。
## 示例
1-2 个典型输入/输出。
3. 注册到平台
SKILL.md 写好后,通过平台 API 注册。参考 agent-platform-api 的 Skill 配置文档(references/config.md 中的「四、Skill」章节)。
注册方式:先用 Write tool 将 SKILL.md 写到 .agents/skills/<name>/SKILL.md,再用 jq --rawfile 从文件读取内容构造 JSON,通过 POST /web/config/skills + action: "set" 提交。
jq -n --rawfile content .agents/skills/my-skill/SKILL.md \
--arg name "my-skill" --arg desc "描述..." \
'{action:"set", name:$name, data:{description:$desc, content:$content}}' | \
curl -s -X POST "$USER_META_BASE_URL/web/config/skills" \
-H "Authorization: Bearer $USER_META_API_KEY" \
-H "Content-Type: application/json" \
-d @- | jq '.data | { name }'
注册后可通过 action: "list" 验证是否生效。
4. 编写原则
- 指令具体可执行,避免"请适当处理"这类模糊表述
- 用编号列表表达步骤顺序
- 解释为什么这样做,而不是堆砌 ALWAYS/NEVER
- 一个 Skill 聚焦单一职责
- 触发关键词覆盖用户可能的表达方式
- 保持 SKILL.md 在 200 行以内,太长说明职责不够聚焦
5. 迭代优化
用户反馈后调整:
- 从反馈中归纳通用问题,而非针对单个 case 修补
- 删掉没用的指令,保持精简
- 如果多个测试场景都重复了相同操作,考虑提取为辅助脚本
- 修改后通过
action: "set" 更新,无需重新创建