用途:把一段自然语言任务描述转成可发布的 Claude Code 技能,重点解决两个常见问题——环境上下文开销过大,以及不跟进最新技能规范(如不了解 arguments/argument-hint、不提示 disable-model-invocation、描述冗长)。
适用时机:想做一个执行某任务的技能、为某流程建斜杠命令、为重复性任务添加技能。
使用前需阅读 reference.md(当前 frontmatter 规范、参数替换、调用与上下文加载行为的快照),先看快照日期,超过 3 个月应提示用户并继续使用该快照,不要在生成过程中重新抓取或修改;规范更新属于维护工作,可从 agent-skill-builder 的规范漂移 CI 同步。同时查看宿主仓库的 CLAUDE.md 与已有技能,避免重复并匹配本地约定。
主要步骤:1)澄清技能:名称用小写连字符,目录名即命令名;确定调用方——仅用户触发(有副作用或由用户控制时机)用 disable-model-invocation: true,仅 Claude 调用用 user-invocable: false,两者皆可用则描述需含触发关键词;有参数则设 argument-hint 并在正文用 $ARGUMENTS 等;明确输入输出、工具(allowed-tools 是预授权而非限制,需收紧范围,如 Bash(git add *))、运行方式(默认 inline,隔离任务用 context: fork + agent:)、加载时动态数据注入(行首 !command)。2)写描述:1–2 句,关键用例在前,第三人称,约 250 字符,细节放正文。3)起草 SKILL.md:frontmatter 只含所需字段,正文为简短目的、When to Use、编号步骤、明确输出格式;正文控制在 500 行内,长参考资料放支持文件;不硬编码 ID、路径、凭据;对外部状态变更加确认门。4)安装:写入 .claude/skills/<skill-name>/SKILL.md,目录名即命令,支持文件同目录,会话内热重载;若已存在需先确认覆盖。5)测试:确认技能被列出,直接调用并核对输出,模型可调用时在新会话验证触发与不触发,可用 /plugin install skill-creator@claude-plugins-official 运行官方评测。6)展示 SKILL.md 与改动供审阅。
限制:资料未提供收费、价格、平台支持范围等信息;具体规范以 reference.md 快照为准。