Skill的结构详解

一个 Skill 文件包含两个主要部分：

• YAML Frontmatter — 顶部的元数据
• Body Content — 下方的 Markdown 指令内容

---
name: my-skill                    # 技能名称（kebab-case）
description: 简要描述技能功能和触发时机  # 关键：说明"做什么"和"何时使用"
metadata:
      author: xxx
      version: "1.0"
---

1）YAML Frontmatter

description 关键技巧：

• 包含用户会说的具体短语（“冲刺规划”“创建任务”“设计规范”）
• 提到相关的文件类型（.fig、.csv、PDF）
• 说清楚适用场景，避免模糊表达

2）Body Content

2026-02-24: Skill 的 Body Content 部分确实没有严格的统一规范

1 无固定格式限制，但建议包含以下部分

• 分步(Step-by-Step)指令 — 清晰的操作步骤
• 输入格式 / 输出格式 / 示例
• 常见边界情况

实用建议：

1. 控制在 500 行以内 | 保持简洁，避免过载
2. 详细内容外移 | 基础内容在 SKILL.md，进阶内容链接到单独文件
3. 引用文件保持一级深度 | 避免嵌套文件引用
4. 清晰简洁，术语一致 | 降低理解成本
5. 文件路径使用正斜杠 | 即使 Windows 也统一用 /

2 根据约束强度，Skill 可分为三个等级：

1. 高自由度:
   1. 通用文本指导；多种方法都有效 -> 创意写作、开放式分析
2. 中自由度
   1. 包含可定制的伪代码、代码示例或模式；有推荐模式但允许一定变化 -> 数据处理、代码生成
3. 低自由度
   1. 引用特定脚本；必须遵循特定顺序 -> 合规检查、精确计算

2.1 复杂工作流处理

• 将复杂操作拆分为清晰的顺序步骤
• 如果步骤过多，考虑将工作流抽离到单独文件

3 一些平台的Body Content的隐性规范

3）可选目录