一个 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
更多
登录后可点赞、收藏、评论和举报。
还没有评论,先发起一个具体问题。