Claude Skill 生成器
用简单的话描述一个你不断重复的任务,即可获得一份完整的 SKILL.md,可直接放入 Claude Code 使用;在你输入的同时,名称和描述会实时对照真实的 Agent Skills 限制进行检查。生成器会按照「做什么、何时使用」的结构撰写描述,因为这正是 Claude 判断某个技能是否适用于某个请求时唯一会读取的字段。当草稿看起来同时覆盖了多个不相关的任务时,它也会实时提示,因为范围狭窄的技能触发起来远比范围宽泛的技能可靠。
1. 描述您反复执行的任务
用通俗的语言描述即可。工作流程越具体,生成的技能就越精准。
或从以下示例中选择一个开始
您的 SKILL.md 将显示在这里,可完全编辑,名称和描述会在您输入时对照 Anthropic 的真实限制进行检查。
SKILL.md 里到底应该写什么
一个 skill 其实就是一个文件夹,里面有一个 SKILL.md:上面是 YAML frontmatter,下面是 Markdown 格式的说明。frontmatter 只有两个字段是必填的,而且这两个字段都有这个工具会在你输入时实时校验的严格规则。name 最多 64 个字符,只允许小写字母、数字和连字符,并且不能包含保留词“claude”或“anthropic”。description 不能为空,且必须少于 1024 个字符——这是唯一值得你反复捉摸的字段,因为它正是 Claude 用来判断某个请求是否与你的 skill 相关的文字。
这就是为什么一个好的 description 要说明两件事:skill 做什么,以及什么时候该触发。只写“审查拉取请求的 diff”本身没有给 Claude 任何可以匹配的信息。而“审查拉取请求的 diff 并标记有风险的改动。当用户要求审查 PR 或在合并前检查 diff 时使用”则准确地说明了哪些请求属于这个 skill。生成器会按这种结构写 description,如果你的描述缺少“触发条件”那一半,就会被标记出来。
frontmatter 下面就是普通的 Markdown——一段简短的概述、## Instructions 下的步骤列表,以及在合适的地方给出的示例。更复杂的 skill 还可以在 SKILL.md 旁边引用额外的捕捉文件(例如 REFERENCE.md,或是一个 Claude 通过 bash 运行的 scripts/ 文件夹),这样繁重的细节只会在真正需要时才被加载。
常见问题
Claude skill 到底是什么?
技能是你一次性交给 Claude、之后可以永久复用的程序性知识:一个包含 SKILL.md 文件的目录,由 YAML frontmatter(名称和描述)加上 Markdown 格式的指令正文组成。当某个请求与描述匹配时,Claude 会加载这些指令并遵循它们。这就是每周重新输入同一个三段式提示词,和只需输入一个斜杠命令之间的区别。技能还可以引用旁边的额外文件——比如 FORMS.md、REFERENCE.md,或者 scripts/ 文件夹下由 Claude 通过 bash 运行的脚本,其中只有输出会进入对话,脚本代码本身不会。
如何写出真正能触发的 Claude skill 描述?
按此顺序说明该技能做什么、以及 Claude 何时应该使用它,用简单的第三人称语言表达。描述是 Claude 判断是否运行你的技能时唯一会拿来与用户请求比对的内容,因此模糊的描述意味着这个技能会被闲置。写出你期望的具体触发场景——例如「当用户要求审查 PR、检查 diff,或询问这些改动中哪里看起来有风险时使用」——并保持在 1024 字符的限制之内。这个 SKILL.md 生成器会按照「做什么加何时用」的结构起草描述,如果某次修改删掉了触发场景的部分,还会实时提醒你。
技能和自定义斜杠命令是一回事吗?
两者有重叠。Claude Code 已经将它们统一起来:命令文件和技能都能提供相同的 /<名称> 行为,接受相同的 frontmatter,并且都支持 $ARGUMENTS 占位符系统。区别在于结构——技能是一个文件夹,因此可以携带配套文件、脚本和渐进式披露的参考资料,并拥有自己的 name 字段(命令文件会忽略 name 和 paths,因为它的文件名本身就是命令名)。命令是单个 Markdown 文件,当任务只是一条简短指令时写起来更快。当工作流程有真正的多个步骤时,使用这个 Claude Code 自定义技能生成器;没有的话,就使用斜杠命令生成器。
我真的应该把一个大技能拆成几个小技能吗?
在大多数情况下,是的——这是 Agent Skills 实践中最常见的错误。一个试图同时覆盖多个不相关职责的技能(比如同时处理提交、撰写 PR 描述和更新更新日志)会触发得很不可靠,因为它的描述必须同时模糊地覆盖这三项任务,导致 Claude 无法判断某个特定请求究竟对应哪一部分。一项针对 47 个热门社区技能的知名评测发现,其中四十个实际上让 Claude 的输出效果比完全不用任何技能还要差,很大程度上正是因为这个原因。当草稿看起来像是覆盖了不止一项任务时,这个生成器会实时提示,并建议将其拆分。
想做的东西更短、只有一行?AI Slash Command Generator 会写出单文件版本——同样的 /command,但脚本架更少。