| name | skill-creator |
| description | 创建、编辑、改进或审计 Skill。当需要从零创建新 skill、改进/审查/清理已有 skill 或 SKILL.md 文件时使用。触发短语如"创建一个 skill"、"优化这个 skill"、"审查 skill"、"create a skill"、"improve this skill"。 |
Skill Creator
本 Skill 指导你创建高质量的 SkillForge Skill 包。
快速开始
创建 skill 的核心流程：
- 理解用途 — 询问用户 skill 的功能、示例、触发条件
- 规划结构 — 确定需要的 scripts/、references/、assets/
- 编写 SKILL.md — frontmatter + 正文
- 创建测试 — evals/evals.json 定义测试用例
- 运行评估 — 用 SubAgent 对比 with-skill vs baseline
- 迭代改进 — 根据反馈优化，重复步骤 3-5
- 打包上传 — zip 后上传到 SkillForge Dashboard
SKILL.md 结构
skill-name/
├── SKILL.md # 必需：frontmatter + 正文
├── evals/ # 可选：测试评估
│ ├── evals.json
│ └── files/
├── scripts/ # 可选：可执行脚本
├── references/ # 可选：参考文档
└── assets/ # 可选：输出模板
Frontmatter（YAML）
| 字段 | 必填 | 说明 |
|---|
name | ✅ | 小写字母 + 数字 + 连字符 |
description | ✅ | 触发机制，描述做什么和何时使用 |
allowed-tools | ❌ | 允许的工具列表 |
triggers | ❌ | 触发关键词数组 |
⚠️ YAML 特殊字符：如果 triggers 包含 [、]、,，必须用双引号包裹：
triggers: ["handle [bracket] cases", "process data"]
正文编写原则
- 使用祈使句/动词原形
- 只包含 Agent 不具备的程序性知识
- 保持 <500 行，超出时拆分到 references/
- 解释为什么重要，而非使用强硬的 MUST
创建流程详解
1. 理解 Skill 用途
询问用户：
- "这个 Skill 应该支持什么功能？"
- "能给一些使用示例吗？"
- "用户说什么话应该触发这个 Skill？"
2. 规划可复用内容
分析示例，识别需要的：
- scripts/ — 反复编写的代码
- references/ — 需要参考的文档
- assets/ — 输出模板
3. 编写 SKILL.md
创建目录：
mkdir -p skill-name/{scripts,references,assets,evals/files}
编写 frontmatter 和正文，遵循上述原则。
4. 创建 Evals
创建 evals/evals.json，定义 2-3 个测试用例：
{
"skill_name": "my-skill",
"evals": [
{
"id": 1,
"prompt": "用户的任务提示",
"expected_output": "预期结果描述",
"files": [],
"expectations": []
}
]
}
5. 运行评估
对每个测试用例，用 SubAgent 运行两次：
With-skill：
Execute this task:
- Skill path: <path-to-skill>
- Task: <eval prompt>
- Save outputs to: <workspace>/iteration-<N>/eval-<ID>/with_skill/outputs/
Baseline：
- 新 skill：无 skill，保存到
without_skill/outputs/
- 改进 skill：用旧版本快照，保存到
old_skill/outputs/
6. 迭代改进
改进后：
- 在新
iteration-<N+1>/ 目录重新运行所有测试
- 等待用户审查反馈
- 根据反馈再次改进
- 重复直到满意
7. 打包上传
cd skill-name && zip -r ../skill-name.zip . -x ".*"
上传到 SkillForge Dashboard → Skills 页面。
命名规范
- 仅使用小写字母、数字和连字符
- 优先用动词开头（如
fix-pr、create-docs）
- 目录名与 Skill 名一致
常见陷阱
| 问题 | 原因 | 解决 |
|---|
| YAML 解析错误 | triggers 含未转义的特殊字符 | 用双引号包裹 |
| Skill 无法触发 | description 过于笼统 | 包含具体任务类型、工具名称 |
| 上下文消耗过多 | 正文过于冗长 | 删除冗余，移至 references/ |
进阶指南
详细指南见 references/：
