用途:该技能用于指导创建新的 Claude Code 技能,遵循官方最佳实践,以提升技能的性能、可发现性与可维护性。
主要能力:
- 判断是否真的需要新建技能:仅当 Claude 缺少特定领域知识、任务需要精确流程或格式、改进可量化时才创建;若 Claude 已能很好完成、仅节省几分钟或任务过于多变/创意化,则不建议创建。
- 先写评测再写文档:建议先建立 3 个以上测试场景,记录输入、期望输出与基线表现,用无技能状态衡量差距。
- 编写最小化的 SKILL.md:控制在 500 行以内(复杂技能目标 300 行以内),用 YAML frontmatter 声明 name、description、version,可选 dependencies。
- 结构与命名规范:目录名用动名词(动词 + -ing),最多 64 字符,仅用小写字母、数字和连字符;主文件为 Skill.md(大写 S);可选 REFERENCE.md、TEMPLATE.md 和 scripts/ 目录。
- 描述规则:使用第三人称,明确“做什么”和“何时用”,包含关键术语,最多 1024 字符。
- 渐进式披露:将详细工作流、排错、模板等移入 references/ 下的一层参考文件,使用全大写文件名,并在 SKILL.md 中给出显式加载指引与“Use when”场景。
- 指令与示例:提供顺序化工作流、2-3 个真实示例、输出模板与验证清单。
- 测试与质量检查:跨模型(Haiku、Sonnet、Opus)测试、新实例测试、基线与真实任务验证,并列出常见反模式。
使用方式: 可通过命令创建目录并放置主文件: mkdir -p ~/.claude/skills/my-skill touch ~/.claude/skills/my-skill/Skill.md 然后在同一会话中按评测、编写、测试、迭代的步骤执行。技能内提供 TEMPLATE.md 可复制为 Skill.md。
适用场景:需要为 Claude Code 新增可复用技能、规范现有技能结构、或改进技能描述与可发现性时。
限制:未提供具体收费、价格或平台支持信息;技能效果依赖实际模型与任务,资料未给出量化结论;部分路径与文件名示例需按实际环境调整。