跳到主要内容
一个 Skill 创建提示词:引导你写出有效的 SKILL.md
景行景行

一个 Skill 创建提示词:引导你写出有效的 SKILL.md

来源:GitHub 仓库 xstongxue/best-prompts 文件 86 行,2.56 KB

一个 Skill 创建指南提示词。

它解决的是:想创建自己的 Skill,但不知道怎么写、结构是什么。

它的结构:

  • 目录结构:SKILL.md(必需)、reference.md、examples.md、scripts/
  • SKILL.md 结构:name、description、使用时机、指令
  • 元数据要求:name 英文小写短横线,最大 64 字符;description 最大 1024 字符,必须包含 WHAT 和 WHEN

它的核心原则: 1. 简洁:只添加 AI 不知道的信息 2. SKILL.md 控制在 500 行以内 3. 渐进式披露:核心指令在 SKILL.md,细节在 reference 4. 自由度匹配:根据任务脆弱程度选择文本指令/伪代码/具体脚本

常见模式:模板模式、示例模式、工作流模式、条件工作流、反馈循环。

反模式:避免 Windows 风格路径、避免提供过多选项、避免时间敏感信息、避免术语不一致、避免模糊的 Skill 名称。

适合谁:

  • 想创建自己 Skill 的科研小组成员
  • 需要写 SKILL.md 但不知道结构的人
  • 想学“怎么写给 AI 看的操作手册”的人

用法: 把这段提示词复制到 AI 工具里,把 Skill 需求填上就行。

提示词

# Role
你是一位精通 Cursor Agent Skills 的专家。你擅长引导用户创建有效的 Skills——即写给 AI 看的「操作手册」,让 AI 在特定场景下按用户定义的套路执行任务。

# Task
根据我提供的【需求描述】,帮助我设计并创建一份完整的 Cursor Skill(SKILL.md 格式)。

# Skill 基本结构

## 目录结构
skill-name/
├── SKILL.md       # 必需:技能定义
├── reference.md   # 可选:详细文档
├── examples.md    # 可选:使用示例
└── scripts/      # 可选:工具脚本

## SKILL.md 结构
name: your-skill-name
description: 这个 Skill 做什么、什么时候用(含触发关键词)

# Skill 名称

## 使用时机
- 场景1
- 场景2

## 指令
- 步骤1
- 步骤2
- 注意事项

## 元数据要求
- name:英文小写短横线,最大 64 字符
- description:最大 1024 字符,必须包含 WHAT(做什么)和 WHEN(何时用)及触发关键词

# 核心原则

1. 简洁:只添加 AI 不知道的信息,每个 token 都要有价值
2. SKILL.md 控制在 500 行以内:详细内容放 reference 文件
3. 渐进式披露:核心指令在 SKILL.md,细节在 reference 中按需引用
4. 自由度匹配:根据任务脆弱程度选择文本指令/伪代码/具体脚本

# 常见模式

- 模板模式:提供输出格式模板
- 示例模式:用具体示例展示期望输出
- 工作流模式:分步骤 + 清单
- 条件工作流:根据决策点分支
- 反馈循环:质量关键任务加入验证步骤

# 反模式避免

- 避免 Windows 风格路径
- 避免提供过多选项(给默认 + 逃生口)
- 避免时间敏感信息
- 避免术语不一致
- 避免模糊的 Skill 名称(如 helper、utils)

# Output Format

1. Skill 设计草案:name、description、主要章节
2. 完整 SKILL.md 内容:可直接保存到 .cursor/skills/skill-name/SKILL.md
3. 可选:reference.md、examples.md 内容(如需要)

# Input

【Skill 需求】:
[在此处描述你的 Skill 要解决什么问题、在什么场景下使用、有哪些关键步骤或约束]

评论 0

更多

登录后可点赞、收藏、评论和举报。

还没有评论,先发起一个具体问题。

0/2000
一个 Skill 创建提示词:引导你写出有效的 SKILL.md - 火花工坊