自己写 Claude Code 技能先看这篇：SKILL.md 每个 frontmatter 字段是干嘛的，11 月 3 日实测版

写 Claude Code 技能其实就是写一个 SKILL.md：一个文件夹加一个文本文件，顶部几行 frontmatter 决定它怎么出现、谁能启动、能用什么工具。AI Parabellum 在 11 月 3 日实测了三个小技能、逐项对照官方文档，把每个字段讲清楚了，想自己动手写技能的人可以直接照着学。

关键字段分三组。起名和描述：name、description、when_to_use、argument-hint、arguments——description 是 Claude 决定何时加载技能的依据，关键用途要写在最前面，description 加 when_to_use 在列表里只显示前 1536 个字符。谁能启动：disable-model-invocation 设为 true 只许你手动调，user-invocable 设为 false 只许 Claude 自己用，paths 可以限定只在匹配的文件上自动加载。工具与环境：allowed-tools、disallowed-tools、model、effort、context: fork 等，控制技能运行时能用什么工具、跑在哪个模型和多大 effort 档位。

照着练：新建一个空文件夹，写个带 7 个字段的 release-note 小技能（读 CHANGES.md，按版本号和受众写发布说明），跑 /release-note 1.0.0 customers 看结果；再加 disable-model-invocation: true 试试行为变化。三个常见坑：— 前面不能有空行或注释，否则整段 frontmatter 变正文；字段名只能用连字符，只有 when_to_use 用下划线，写错了不报错、直接被忽略；想上传到 claude.ai 的话只能留 name、description、license、compatibility、metadata、allowed-tools 这 6 个字段。相关阅读：CLAUDE.md 模板照着抄、AGENTS.md 和 CLAUDE.md 只能二选一？。更多细节见 AI Parabellum 的完整指南。

来源：AI Parabellum，原文：https://aiparabellum.com/skill-md-format-explained-claude-code-frontmatter-fields/