free-ai-lab free-ai-lab

SKILL.md 写法详解

进阶教程

字段说明 + 10 个可直接复制的模板 + 让 Skill 更稳的进阶技巧。

一句话:SKILL.md 就三件套——头部「告诉 AI 你是谁、何时用」,正文「具体怎么做」,示例「长什么样」。本文把每个字段拆开讲,再给你 10 个模板直接抄。

零基础可以先看 四步创建教程,本文是进阶参考。

结构总览

--- name: skill-name ← 小写短横线 id description: 做什么 + 何时用 ← 最关键,AI 靠它判断激活 --- # 主标题 (正文:步骤、规则、边界) ## 示例 (输入 → 输出,给 AI 参考样子)
frontmatter(头部)

name + description,YAML 格式

正文

具体步骤 + 边界 + 规则,越具体越稳

示例

输入 → 理想输出,锚定 AI 产出标准

头部字段怎么写得最好

description 是命门

它决定 AI「什么时候想起这个 Skill」。写得越贴近用户原话,命中率越高。

❌ 太含糊(AI 不知道何时用)
description: 帮助写文案
✅ 精确(触发场景全覆盖)
description: 按小红书爆款套路写种草笔记。当用户说「写小红书文案」「帮我写一篇种草笔记」「发篇笔记」或粘贴产品信息时使用。
name 命名约定

小写字母 + 短横线(如 weekly-report-writer),一眼能看出功能。别用空格、大写、中文。

10 个可直接复制的场景模板

把下面任意一个存成文件夹(含同名 SKILL.md)就能用,替换里面的示例即可:

1️⃣ 会议纪要 Skill
--- name: meeting-notes description: 把会议记录整理成结构化纪要。用户粘贴会议记录或说「整理今天的会议」时使用。 --- # 会议纪要 1. 先识别并输出:会议主题、时间、参会人 2. 按「决定事项 / 待办任务 / 遗留问题」三区整理 3. 待办任务每人一项,格式:负责人 + 做什么 + 截止时间(缺失用【待补充】标出) 4. 不添加记录里没有的信息 ## 示例 输入:今天的会定了产品要加导出功能,我负责后端,小张负责前端,周五前出demo… 输出: ### 决定事项 - 产品新增导出功能 ### 待办任务 - 小明:后端导出实现(【待补充】截止)
2️⃣ 邮件润色 Skill(商务风)
--- name: email-polisher description: 把粗糙邮件草稿改写为专业商务邮件。用户粘贴邮件草稿或说「帮我润色邮件」时使用。 --- # 邮件润色 1. 保留所有关键信息点 2. 优化称呼、开头、结尾礼节 3. 长句拆短,一段只讲一件事 4. 输出:润色后邮件 + 3 行以内修改说明 ## 示例 输入:王总你好,上次说的那个合作定了,你说啥时候签? 输出:王总您好:关于此前沟通的合作事宜,我方已确认推进。不知您方便的时间是否已确定,我们可随时配合安排签约。祝好!
3️⃣ 周报生成 Skill
--- name: weekly-report description: 把零散工作记录整理成结构清晰的中文周报。用户粘贴流水账或说「帮我写周报」时使用。 --- # 周报生成 1. 将记录按「本周成果 / 遇到的问题 / 下周计划」分类 2. 成果按重要性排序,每条附数据(缺失用【待补充】) 3. 输出 2 个周报标题建议供选择 4. 保持事实,不编造未发生事项 ## 示例…
4️⃣ 简历优化 Skill
--- name: resume-polisher description: 优化简历描述,使表达更职业量化。用户粘贴简历或说「优化简历」时使用。 --- # 简历优化 1. 动作开头(如「主导了」「实现了」),避免第一人称 2. 尽量量化成果(数字、百分比),没有就保留原文 3. 每条经历 1-2 行,删除空话套话 4. 输出:优化后清单 + 改动要点说明
5️⃣ 代码审查 Skill(前端)
--- name: frontend-code-review description: 按可维护性与无障碍标准审查前端代码。用户说「检查这段代码」或粘贴代码时使用。 --- # 前端代码审查 1. 逐项检查:可读性 / 可访问性(aria) / 性能(重复渲染) / 安全(XSS) 2. 每个问题给出:文件行号 + 问题 + 修复建议代码 3. 按严重程度排序输出 4. 无问题时明确说「未发现问题」
6️⃣ 图片提示词生成 Skill
--- name: image-prompt-writer description: 把中文画面描述转成高质量英文 AI 生图提示词。用户说「帮我写个生图提示词」时使用。 --- # 生图提示词 1. 用英文输出,结构:主体 + 环境 + 光线 + 构图 + 风格 + 质量词 2. 质量词固定收尾:high quality, 4k 3. 根据场景自动选择合适风格描述(写实/插画/3D/海报) 4. 输出提示词后附 2 行中文解释
7️⃣ 学习笔记整理 Skill
--- name: study-notes description: 把散乱学习资料整理为结构化笔记与记忆卡片。用户粘贴资料或说「整理学习笔记」时使用。 --- # 学习笔记 1. 提取核心概念,用「一句话定义」开头 2. 按主题分级组织,加示例 3. 生成 5 张问答记忆卡片(Q/A 形式) 4. 输出适合导入笔记软件的 Markdown
8️⃣ 数据分析解读 Skill
--- name: data-interpreter description: 解读一份数据(表格/数字),给出洞察与建议。用户粘贴数据或说「分析这份数据」时使用。 --- # 数据解读 1. 先概述整体情况,再列显著趋势/异常 2. 区分「数据事实」与「推测」,推测须标注 3. 给 3 条以上可执行的下一步建议 4. 表格形式输出对比数据
9️⃣ 短视频脚本 Skill
--- name: short-video-script description: 把选题写成 30-60 秒短视频口播脚本。用户说「写个短视频脚本」「这条文案改视频脚本」时使用。 --- # 短视频脚本 1. 结构:3 秒钩子 + 15 秒主体点 + 结尾引导 2. 口播化:短句、口语、停顿标注 3. 每 10 秒给一个画面提示(镜头/字幕) 4. 时长控制在 45 秒内,300 字左右
🔟 旅行规划 Skill
--- name: travel-planner description: 根据时间/预算/偏好输出旅行行程。用户说「帮我规划旅行」「做份旅游攻略」时使用。 --- # 旅行规划 1. 先确认要素:天数、预算、出发地与目的地、偏好(美食/自然/人文) 2. 每天早中晚排程:景点 + 交通 + 餐饮 3. 标注每个景点的预计停留时间 4. 附:预算估算表 + 3 条实用提醒(如订票/天气)

模板化思路:把「高频重复的工作流」固化成 Skill,是比收藏提示词更进阶的用法——装一次,AI 以后每次都按你的标准来。

进阶技巧:让 Skill 更稳

  • 加「反例」:正文写「不要做什么」能显著减少越界(如「不要编造数据」「不要在不确定时替换原名」)
  • 给输出格式:明确要求「表格形式」「### 开头」「3 行以内」,AI 的输出结构会更稳定
  • 示例放在最后”锚定”:示例不仅是展示,更是让 AI 对齐产出标准的参照物
  • 用 scripts/ 接手机械活:反复的计算、格式化交给脚本,SKILL.md 只负责"指挥"
  • 迭代式打磨:实测 3 个输入 → 把 AI 犯错的地方补进正文 → 再测,Skill 越用越准

相关阅读