---

name: 如何创建Claude代码技能 description: 创建Claude代码技能的指南。

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

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

---

name: 你的技能名称 description: 简要描述此技能的功能和使用时机

你的技能名称

使用说明

[为Claude提供的清晰、分步指导]

示例

[使用此技能的具体示例]

完整的技能目录结构 随着技能复杂性的增长，可以包含额外的支持文件2：

my-skill/ ├── SKILL.md (必需) ├── reference.md (可选文档) ├── examples.md (可选示例) ├── scripts/ │ └── helper.py (可选工具) └── templates/ └── template.txt (可选模板)

渐进式披露模式示例 文档展示了一个PDF处理技能的完整结构3：

pdf/ ├── SKILL.md # 主要使用说明（触发时加载） ├── FORMS.md # 表单填写指南（按需加载） ├── reference.md # API参考（按需加载） ├── examples.md # 使用示例（按需加载） └── scripts/ ├── analyze_form.py # 实用脚本（执行，不加载） ├── fill_form.py # 表单填写脚本 └── validate.py # 验证脚本

技能存储位置 在Claude代码中，技能可以存储在不同位置2：

个人技能：

mkdir -p ~/.claude/skills/my-skill-name

项目技能：

mkdir -p .claude/skills/my-skill-name

文件引用方式 在SKILL.md中可以引用其他文件2：

For advanced usage, see reference.md.

运行帮助脚本：

python scripts/helper.py input.txt

技术要求

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

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

其他要求

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

“处理PDF文件” “分析电子表格” “管理数据库” “测试代码” “编写文档”

避免的命名方式：

模糊名称：“助手”、“工具”、“实用程序” 过于通用：“文档”、“数据”、“文件”

技能的组织结构 对于包含多个相关技能的项目，可以按功能域组织：

.claude/skills/ ├── pdf-processing/ │ └── SKILL.md ├── excel-analysis/ │ └── SKILL.md ├── git-workflow/ │ └── SKILL.md └── code-review/ └── SKILL.md

这样的组织方式使得技能更容易引用、讨论和维护6。