用途
Create Skill 是一个帮助用户创建新 Claude Code 技能的指南型技能,目标是让新技能遵循官方最佳实践和标准。当用户想要创建新技能、构建自定义技能、扩展 Claude 能力,或提到创建、设计、构建技能时,可以使用它。
主要能力
该技能提供了一套创建技能的工作流和规范参考,包括:
- 创建工作流:理解需求(询问技能用途的澄清问题)、选择位置、创建目录结构、编写 SKILL.md、测试激活。
- SKILL.md 格式规范:每个技能都需要一个 SKILL.md 文件,包含 YAML frontmatter 和 Markdown 格式的正文说明。
- Frontmatter 字段要求:必填字段为
name(仅小写字母、数字、连字符,最多 64 字符)和description(说明技能做什么以及何时使用,最多 1024 字符);可选字段为allowed-tools(逗号分隔的列表,用于限制工具访问)。 - 描述编写最佳实践:描述应同时包含技能做什么以及何时使用,提及具体文件类型、工作流或用户可能说出的关键词,并加入能区分相似技能的触发词,需足够具体以便 Claude 自主决定是否使用。
- 目录结构示例:简单技能仅需 SKILL.md;复杂技能可包含 reference.md、examples.md、scripts/ 目录(如 helper.py、utilities.sh)、templates/ 目录(如 template.txt、sample.json)等支持文件。
- 引用支持文件:在 SKILL.md 中使用相对路径引用支持文件;Claude 会按需逐步加载支持文件以高效管理上下文。
- 工具限制:通过
allowed-tools限制技能激活时 Claude 可使用的工具,适用于安全敏感工作流、限定范围的技能以及确保无需权限即可执行。 - 技能位置:个人技能位于
~/.claude/skills/(跨项目可用、本机私有、不受版本控制);项目技能位于.claude/skills/(通过 git 与团队共享、项目专属、队友拉取后自动可用);插件技能随已安装插件打包,推荐用于分发。 - 创建检查清单:确认 SKILL.md 存在且 frontmatter 有效、名称仅含小写字母数字和连字符、描述包含做什么和何时用、包含具体触发词、不超过 1024 字符、支持文件使用 Unix 风格路径、说明清晰可操作、工具限制恰当、目录位置正确。
- 测试方法:重启 Claude Code 使更改生效;使用描述中的触发词验证激活;运行
claude --debug查看加载错误;确认技能产生预期结果。 - 常见问题排查:技能未激活(描述太模糊、文件位置错误、YAML 无效)、支持文件找不到(路径问题、权限问题)、工具访问被拒绝(检查 allowed-tools 限制)。
- 版本历史模板:可在 SKILL.md 中包含版本历史以跟踪变更。
- 技能共享:推荐通过插件分发;项目共享时在
.claude/skills/skill-name/创建并提交到 git。
使用方式
当用户请求创建技能时,按以下流程操作:澄清需求(技能应做什么、何时激活)、选择位置(个人或项目技能)、设计结构(简单或复杂)、编写 frontmatter(名称和含触发词的描述)、编写说明(清晰可操作的 Markdown 内容)、按需添加支持文件(模板、脚本、文档)、按安全或范围需要设置工具限制、在正确位置创建所有文件、提供测试指导。
适用场景
适用于用户需要创建新技能、构建自定义技能、扩展 Claude 能力,或提到创建、设计、构建技能的场景。也适合需要参考技能结构规范、frontmatter 字段要求、描述编写方法、目录组织方式、工具限制配置、技能位置选择、测试与排错方法的用户。
限制
该技能本身为指南型内容,未提供具体安装命令或独立安装方式。技能的激活由模型根据描述自主决定。资料中未提供收费、价格、平台支持范围、实际效果保证等信息。