⚡

创建代理技能Skill creating-agent-skills

提供专家指导，帮助用户创建、编写和改进Claude代码技能。涵盖SKILL.md文件操作、新技能编写、现有技能改进、技能结构理解和最佳实践应用。关键词：Claude代码技能，SKILL.md，技能创建，AI代理，最佳实践

AI智能体 0 次安装 0 次浏览 更新于 3/9/2026

name: 创建代理技能 description: 专家指导如何创建、编写和改进Claude代码技能。在操作SKILL.md文件、编写新技能、改进现有技能或理解技能结构和最佳实践时使用。

创建代理技能

这个技能教授如何根据Anthropic官方规范创建有效的Claude代码技能。

核心原则

1. 技能即提示

所有提示最佳实践均适用。要清晰、直接。假设Claude是智能的——只添加Claude没有的上下文。

2. 标准Markdown格式

使用YAML前导元数据+markdown正文。不要使用XML标签——使用标准markdown标题。

---
name: 我的技能名称
description: 它做什么以及何时使用它
---

# 我的技能名称

## 快速入门
立即可行的指导...

## 指令
逐步程序...

## 示例
具体使用示例...

3. 渐进披露

保持SKILL.md在500行以内。将详细内容拆分到参考文件中。仅加载所需内容。

我的技能/
├── SKILL.md              # 入口点（必需）
├── reference.md          # 详细文档（需要时加载）
├── examples.md           # 使用示例
└── scripts/              # 实用脚本（执行，不加载）

4. 有效描述

描述字段启用技能发现。包括技能做什么AND何时使用它。用第三人称书写。

好：

description: 从PDF文件中提取文本和表格，填写表单，合并文档。在处理PDF文件或用户提及PDFs、表单或文档提取时使用。

坏：

description: 帮助处理文档

技能结构

必需的前导元数据

字段 必需 最大长度 描述
name 是 64字符 仅小写字母、数字、连字符
description 是 1024字符 它做什么AND何时使用它
allowed-tools 否 - Claude可以不经询问使用的工具
model 否 - 使用的特定模型

命名约定

使用动名词形式（动词+ -ing）作为技能名称：

  • 处理-pdfs
  • 分析-电子表格
  • 生成-提交消息
  • 审查-代码

避免：助手, 工具, 实用程序, anthropic-*, claude-*

正文结构

使用标准markdown标题：

# 技能名称

## 快速入门
最快获得价值的路径...

## 指令
Claude遵循的核心指导...

## 示例
展示预期行为的输入/输出对...

## 高级功能
附加能力（链接到参考文件）...

## 指南
规则和约束...

您想做什么？

  1. 创建新技能 - 从零开始构建
  2. 审核现有技能 - 对照最佳实践检查
  3. 添加组件 - 添加工作流/参考/示例
  4. 获取指导 - 理解技能设计

创建新技能

步骤1：选择类型

简单技能（单文件）：

  • 500行以内
  • 自包含指导
  • 无复杂工作流

渐进披露技能（多文件）：

  • SKILL.md作为概述
  • 参考文件用于详细文档
  • 脚本用于实用程序

步骤2：创建SKILL.md

---
name: 您的技能名称
description: [它做什么]。在[触发条件]时使用。
---

# 您的技能名称

## 快速入门

[立即可行的示例]

```[语言]
[代码示例]

指令

[核心指导]

示例

示例1： 输入：[描述] 输出：

[结果]

指南

  • [约束1]
  • [约束2]

### 步骤3：添加参考文件（如果需要）

从SKILL.md链接到详细内容：

```markdown
有关API参考，请参阅[REFERENCE.md](REFERENCE.md)。
有关表单填写指南，请参阅[FORMS.md](FORMS.md)。

保持参考从SKILL.md一级深。

步骤4：添加脚本（如果需要）

脚本执行而不加载到上下文中：

## 实用脚本

提取字段：
```bash
python scripts/analyze.py input.pdf > fields.json


### 步骤5：用真实使用测试

1. 用实际任务测试，而非测试场景
2. 观察Claude的困难点
3. 基于真实行为改进
4. 用Haiku、Sonnet和Opus测试

## 审核现有技能

对照此清单检查：

- [ ] 有效YAML前导元数据（名称+描述）
- [ ] 描述包括触发关键词
- [ ] 使用标准markdown标题（非XML标签）
- [ ] SKILL.md在500行以内
- [ ] 参考一级深
- [ ] 示例具体，非抽象
- [ ] 一致术语
- [ ] 无时间敏感信息
- [ ] 脚本显式处理错误

## 常见模式

### 模板模式

为一致结果提供输出模板：

```markdown
## 报告模板

```markdown
# [分析标题]

## 执行摘要
[一段概述]

## 关键发现
- 发现1
- 发现2

## 建议
1. [行动项]
2. [行动项]


### 工作流模式

对于复杂多步骤任务：

```markdown
## 迁移工作流

复制此清单：
  • [ ] 步骤1：备份数据库
  • [ ] 步骤2：运行迁移脚本
  • [ ] 步骤3：验证输出
  • [ ] 步骤4：更新配置

**步骤1：备份数据库**
运行：`./scripts/backup.sh`
...

条件模式

指导通过决策点：

## 选择您的方法

**创建新内容？** 遵循下面的“创建工作流”。
**编辑现有？** 遵循下面的“编辑工作流”。

要避免的反模式

  • 正文中的XML标签 - 使用markdown标题代替
  • 模糊描述 - 用触发关键词具体
  • 深层嵌套 - 保持参考从SKILL.md一级深
  • 太多选项 - 提供默认加退出途径
  • Windows路径 - 始终使用正斜杠
  • 推给Claude - 脚本应处理错误
  • 时间敏感信息 - 使用“旧模式”部分代替

参考文件

有关详细指导，请参阅：

成功标准

一个结构良好的技能：

  • 具有有效YAML前导元数据，包含描述性名称和描述
  • 使用标准markdown标题（非XML标签）
  • 保持SKILL.md在500行以内
  • 链接到参考文件用于详细内容
  • 包括具体示例，带有输入/输出对
  • 已用真实使用测试

来源：