Skill 创建工具

使用场景

当用户需要：

• 创建新的 Cursor Skill

• 更新或改进现有 Skill

• 验证 Skill 文件结构

• 打包 Skill 用于分发

• 理解 Skill 的最佳实践

Skill 结构

每个 Skill 应包含以下结构：

skill-name/ ├── SKILL.md (必需) │ ├── YAML frontmatter (必需) │ │ ├── name: (必需) │ │ └── description: (必需) │ └── Markdown 指令内容 (必需) └── 可选资源 ├── scripts/ # 可执行代码 ├── references/ # 参考文档 └── assets/ # 资源文件

SKILL.md 模板

Frontmatter（必需）

name: skill-name description: 清晰描述技能的功能和使用场景。这是主要的触发机制，应包含技能做什么以及何时使用它。描述应包含所有"何时使用"的信息，而不是放在正文中。

描述编写指南

• 包含功能：明确说明技能做什么

• 包含触发条件：说明何时使用此技能

• 具体场景：列举具体的使用场景

• 避免冗余：不要在正文中重复描述信息

正文内容

• 使用命令式/不定式形式编写指令

• 保持简洁，避免不必要的解释

• 提供清晰的步骤和示例

• 引用相关资源文件（如 scripts、references）

创建流程

1. 理解需求

• 明确技能要解决的问题

• 识别具体的使用场景

• 确定需要的资源和工具

2. 规划资源

• Scripts：需要重复执行的代码

• References：参考文档和知识库

• Assets：模板、图标等资源文件

3. 编写 SKILL.md

• 编写清晰的 frontmatter

• 组织指令内容

• 添加使用示例和最佳实践

4. 验证和测试

• 检查 YAML 格式

• 验证文件结构

• 测试技能触发和使用

最佳实践

命名规范

• 使用小写字母、数字和连字符

• 名称应简短且描述性（< 64 字符）

• 使用动词开头的短语（如 create-web-app ）

描述质量

• 描述应全面且具体

• 包含所有触发场景

• 避免在正文中重复描述信息

内容组织

• 保持 SKILL.md 简洁（< 500 行）

• 将详细内容移到 references 文件

• 使用渐进式披露原则

资源管理

• 只包含必要的文件

• 避免创建辅助文档（README、CHANGELOG 等）

• 保持目录结构清晰

验证检查清单

• YAML frontmatter 格式正确

• name 和 description 字段存在

• 描述包含功能和使用场景

• 文件结构符合规范

• 资源文件引用正确

• 代码示例可执行（如适用）

注意事项

• Skill 应该专注于 AI 代理的工作，而不是用户文档

• 避免在 Skill 中包含安装指南、变更日志等

• 保持内容简洁，充分利用上下文窗口

• 根据任务复杂度设置适当的自由度