用途
create-skill 用于创建一个新的技能(Skill),以专门的知识、工作流或工具集成来扩展 Claude 的能力。该技能仅在输入 /create-skill 时触发。
核心原则
简洁是关键。上下文窗口是共享资源,只应添加 Claude 本身不具备的上下文。对每一部分内容都应质疑:“Claude 真的需要这个吗?”
技能的结构
一个技能由以下部分组成:
skill-name/
├── SKILL.md (required)
│ ├── YAML frontmatter (name, description)
│ └── Markdown instructions
└── Bundled Resources (optional)
├── scripts/ - Executable code
├── references/ - Documentation
└── assets/ - Templates, images
其中 SKILL.md 为必需项,包含 YAML frontmatter(name、description)和 Markdown 指令;捆绑资源为可选项,包括 scripts/(可执行代码)、references/(文档)、assets/(模板、图片)。
SKILL.md 格式
---
name: my-skill-name
description: A clear description of what this skill does and when to use it
---
# My Skill Name
[Instructions for Claude when this skill is active]
## Examples
- Example usage 1
- Example usage 2
## Guidelines
- Guideline 1
- Guideline 2
技能创建流程
第 1 步:通过示例理解
收集该技能将被如何使用具体示例。询问:
- “这个技能应该支持什么功能?”
- “用户会说什么话来触发这个技能?”
第 2 步:规划可复用内容
分析示例以识别:
- Scripts:会被反复重写的代码
- References:Claude 需要参考的文档
- Assets:用于输出的模板、图片
第 3 步:初始化
创建技能目录结构,包含 SKILL.md 和资源文件夹。
位置:skills/[skill-name]/SKILL.md
第 4 步:实现
- 从可复用资源(scripts、references、assets)开始
- 编写带有正确 frontmatter 的清晰 SKILL.md
- 通过实际运行来测试脚本
第 5 步:迭代
在真实任务中使用该技能,注意遇到的困难,并加以改进。
渐进式披露
保持 SKILL.md 在 500 行以内。拆分内容,例如:
# PDF Processing
## Quick start
[code example]
## Advanced features
- **Form filling**: See [FORMS.md](FORMS.md)
- **API reference**: See [REFERENCE.md](REFERENCE.md)
不应包含的内容
- README.md
- INSTALLATION_GUIDE.md
- CHANGELOG.md
- 面向用户的文档
技能是给 AI 智能体使用的,不是给人类使用的。
Frontmatter 选项
---
name: skill-name # Required: identifier
description: When to use # Required: triggers skill discovery
references: # Optional: files to load progressively
- references/api.md
- references/examples.md
allowed-tools: # Optional: restrict tool access
- Bash(git:*)
- Read
- Write
---
其中 name 为必填(标识符),description 为必填(触发技能发现),references 为可选(渐进式加载的文件),allowed-tools 为可选(限制工具访问)。
适用场景
适用于需要为 Claude 创建新技能、扩展其专门知识、工作流或工具集成能力的场景。
限制
该技能仅在输入 /create-skill 时触发。关于收费、价格、平台支持范围等信息,资料中暂未提供。