一、最简上手
一个 SKILL.md 文件不需要任何 Frontmatter 就能工作。Claude 会用目录名作为 Skill 名称，用正文第一段作为描述。
添加 Frontmatter 的最简形式只需要一个 description：
验证方式：在 Claude Code 中输入 /，确认 Skill 出现在命令菜单中，描述文本正确显示。
二、更多字段
Frontmatter 支持 15+ 个字段，全部可选。按使用频率排列，最常用的字段：
以下 6 个字段覆盖日常使用的绝大多数场景。
name
决定斜杠命令的名称（/code-review）。仅允许小写字母、数字和连字符，最长 64 字符，不能以连字符开头或结尾，不能连续连字符。
省略时使用目录名。只有当命令名需要和目录名不同时才需要设置。
description
Claude 判断"是否自动加载此 Skill"的核心依据。上限 1024 字符，但 Claude Code 在 Skill 列表中只显示前 250 字符——最关键的触发信息放在开头。
省略时使用正文第一段。推荐包含具体触发场景（"Use when..."），并使用用户可能说的短语作为关键词。
disable-model-invocation
设为 true 时，Claude 不会自动调用此 Skill——只有你手动输入 /skill-name 才能触发。默认 false。
适合有副作用的操作（部署、提交、发消息），或你需要精确控制触发时机的场景。
user-invocable
设为 false 时，Skill 从 / 菜单中隐藏，只有 Claude 自动匹配时才会使用。默认 true。
适合背景知识类 Skill（项目架构说明、遗留系统文档），用户直接调用没有意义，但 Claude 处理相关代码时应该知道这些信息。
allowed-tools
限制 Skill 运行时 Claude 可使用的工具。列出的工具无需逐次确认（预批准）。支持 MCP 工具（mcp__postgres__*）和 Bash 子命令（Bash(git:*)）。
空格分隔或 YAML 列表格式均可。