how to create claude code skill

Skills的文件结构有以下几种组织方式：

基本Skill结构每个Skill都需要一个SKILL.md文件，包含YAML前置元数据1：

name: Your Skill Name description: Brief description of what this Skill does and when to use it

Your Skill Name

Instructions

[Clear, step-by-step guidance for Claude to follow]

Examples

[Concrete examples of using this Skill] 完整的Skill目录结构随着Skill复杂性的增长，可以包含额外的支持文件2：

my-skill/ ├── SKILL.md (required) ├── reference.md (optional documentation) ├── examples.md (optional examples) ├── scripts/ │ └── helper.py (optional utility) └── templates/ └── template.txt (optional template) 渐进式披露模式示例文档展示了一个PDF处理Skill的完整结构3：

pdf/ ├── SKILL.md # Main instructions (loaded when triggered) ├── FORMS.md # Form-filling guide (loaded as needed) ├── reference.md # API reference (loaded as needed) ├── examples.md # Usage examples (loaded as needed) └── scripts/ ├── analyze_form.py # Utility script (executed, not loaded) ├── fill_form.py # Form filling script └── validate.py # Validation script Skill存储位置在Claude Code中，Skills可以存储在不同位置2：

个人Skills：

mkdir -p ~/.claude/skills/my-skill-name 项目Skills：

mkdir -p .claude/skills/my-skill-name 文件引用方式在SKILL.md中可以引用其他文件2：

For advanced usage, see reference.md.

Run the helper script:

python scripts/helper.py input.txt

技术要求

保持SKILL.md主体内容在500行以下以获得最佳性能(4)
YAML前置元数据字段限制：name最多64字符，description最多1024字符(4)
避免深层嵌套引用，保持引用深度在一级以内(3)

Claude只在需要时读取这些文件，使用渐进式披露来高效管理上下文(1)。

其他要求

推荐的命名示例（动名词形式）：

"Processing PDFs" "Analyzing spreadsheets" "Managing databases" "Testing code" "Writing documentation" 避免的命名方式：

模糊名称："Helper"、"Utils"、"Tools" 过于通用："Documents"、"Data"、"Files" Skills的组织结构对于包含多个相关Skills的项目，可以按功能域组织：

.claude/skills/ ├── pdf-processing/ │ └── SKILL.md ├── excel-analysis/ │ └── SKILL.md ├── git-workflow/ │ └── SKILL.md └── code-review/ └── SKILL.md 这样的组织方式使得Skills更容易引用、讨论和维护6。