一、最简上手
一个 SKILL.md 文件不需要任何 Frontmatter 就能工作。Claude 会用目录名作为 Skill 名称，用正文第一段作为描述。
添加 Frontmatter 的最简形式只需要一个 description：
验证方式：在 Claude Code 中输入 /，确认 Skill 出现在命令菜单中，描述文本正确显示。
二、更多字段
Frontmatter 支持 18+ 个字段，全部可选。按使用频率排列，最常用的字段：
以下 8 个字段覆盖日常使用的绝大多数场景。
name
决定斜杠命令的名称（/code-review）。仅允许小写字母、数字和连字符，最长 64 字符，不能以连字符开头或结尾，不能连续连字符。
省略时使用目录名。只有当命令名需要和目录名不同时才需要设置。
description
Claude 判断"是否自动加载此 Skill"的核心依据。description 和 when_to_use 合计上限 1,536 字符——超出部分在 Skill 列表中被截断。关键触发信息放在 description 开头。
省略时使用正文首段。description 写 WHAT，when_to_use 写 WHEN + WHEN NOT。
when_to_use
补充 Claude 自动触发此 Skill 的条件。内容追加到 description 之后，共同参与 Skill 列表的语义匹配，合计受 1,536 字符上限约束。
description 侧重功能描述（做什么），when_to_use 侧重触发场景（何时用/何时不用的具体短语）。
arguments
命名位置参数。接受空格分隔字符串或 YAML 列表。名称按顺序映射到调用参数位置。
设置 arguments: env file_path 后，/deploy production app.ts 中 $env 展开为 production，$file_path 展开为 app.ts。