⚡

技能模板创建指南Skill skill-name

这个技能是一个模板，用于创建和管理AI助手技能文件。它详细介绍了技能描述的编写、触发关键词的设置、使用场景的定义、结构模式的选择，并提供示例和资源管理指南。适用于AI技能开发者、系统集成者和定制化AI助手项目。关键词：技能模板、AI助手、技能开发、Markdown文档、触发器关键词。

低代码开发 0 次安装 0 次浏览 更新于 3/11/2026

name: 技能名称 description: TODO: [它做什么]。 使用当 [特定触发器]。 示例: “分析Excel电子表格并生成图表。 使用当处理Excel文件、.xlsx、电子表格分析或数据可视化。” 必须: 包括 “使用当…” 带有触发器关键词 (文件类型、领域、任务)。 第三人称。 最大1024字符。

技能名称

注意: 这是一个模板文件。 在复制此目录以创建新技能后，自定义YAML frontmatter并替换所有TODO部分为您的技能内容。

TODO: 简要1-2句概述。 简洁 - 上下文窗口与对话历史、其他技能和用户请求共享。

概述

TODO: 详细介绍解释此技能的目的和范围 (1段落)。

何时使用此技能

此技能应使用当:

  • TODO: 列出此技能应激活的特定场景
  • TODO: 包括应触发激活的文件类型、操作或关键词
  • TODO: 尽可能具体以帮助Claude发现何时使用

快速开始

TODO: 提供最快实现价值的方法。 展示最常见用例，并附简要示例。

示例:

# TODO: 替换为实际的快速开始命令或代码片段
echo "Hello, world!"

[主要指令部分]

TODO: 根据您的技能目的选择并实现以下结构模式之一:

选项1: 基于工作流的模式 (用于顺序过程)

使用当: 多步骤过程、顺序操作、引导工作流

模式结构:

## 工作流决策树
## 步骤1: 初始设置
## 步骤2: 配置
## 步骤3: 执行
## 故障排除

对于复杂工作流，提供检查清单:

## PDF表单填写工作流

复制此检查清单并勾选项目以完成:

```
任务进度:
- [ ] 步骤1: 分析表单
- [ ] 步骤2: 创建字段映射
- [ ] 步骤3: 验证映射
- [ ] 步骤4: 填写表单
- [ ] 步骤5: 验证输出
```

**步骤1: 分析表单**
[此步骤的指令]

**步骤2: 创建字段映射**
[此步骤的指令]

[继续每个步骤...]

选项2: 基于任务模式 (用于操作集合)

使用当: 工具集合、实用技能、多个独立能力

模式结构:

## 任务类别1: [名称]
### 任务1.1: [操作]
### 任务1.2: [操作]
## 任务类别2: [名称]
### 任务2.1: [操作]

选项3: 基于参考模式 (用于指南/标准)

使用当: 样式指南、编码标准、品牌指南、API规范

模式结构:

## 核心原则
## 指南
## 规范
## 使用示例

选项4: 基于能力模式 (用于集成功能)

使用当: 复杂系统、集成工具、多能力技能

模式结构:

## 核心能力
## 能力1: [功能名称]
## 能力2: [功能名称]
## 集成指南

选项5: 验证反馈循环模式 (用于需要正确性的操作)

使用当: 复杂操作、批量更新、错误成本高的操作

模式结构:

## 带验证的工作流

### 步骤1: 分析输入
[理解需求]

### 步骤2: 生成计划
创建中间计划文件 (例如，changes.json)

### 步骤3: 验证计划

```bash
python scripts/validate_plan.py plan.json
```

### 步骤4: 审查错误
如果发现错误，修复并返回步骤3

### 步骤5: 执行计划
应用已验证的计划

### 步骤6: 验证输出
确认输出满足需求

关键原则: 通过中间验证在昂贵操作之前捕捉错误。

示例

TODO: 提供具体、代表性示例，包含输入/输出对。 示例帮助Claude比描述更好地理解所需样式和详细程度。

示例1: 基本使用

TODO: 展示简单、常见用例。 使用输入/输出格式:

输入: [用户提供的内容]
预期输出:
[显示应产生的准确内容]

格式指南: 显示具体输入 → 输出对。 例如，如果此技能生成提交消息，显示:

  • 输入: “为这些更改创建提交消息: 添加用户认证”
  • 输出: "feat(auth): 实现用户认证系统

添加登录端点和会话管理"

示例2: 高级使用

TODO: 使用相同输入/输出格式展示更复杂或更强大的用例:

输入: [更复杂的场景]
预期输出:
[显示完整输出，包含所有细节]

模式提示: 像在常规提示中一样使用输入/输出对，以向Claude展示所需的格式和质量水平。 这比仅描述效果更好。

资源

此技能包括示例资源目录，展示如何组织不同类型的捆绑资源:

scripts/

可执行代码 (Python/Bash等) 可以直接运行以执行特定操作。

来自其他技能的示例:

  • PDF技能: fill_fillable_fields.py, extract_form_field_info.py - PDF操作的实用程序
  • DOCX技能: document.py, utilities.py - 文档处理的Python模块

适用于: Python脚本、shell脚本或任何执行自动化、数据处理或特定操作的可执行代码。

注意: 脚本可能在不加载到上下文的情况下执行，但Claude仍可读取以进行修补或环境调整。

TODO: 如果您的技能包括脚本，在此列出:

  • scripts/example.py - TODO: 描述此脚本做什么

references/

文档和参考资料，旨在加载到上下文中以告知Claude的流程和思维。

来自其他技能的示例:

  • 产品管理: communication.md, context_building.md - 详细工作流指南
  • BigQuery: API参考文档和查询示例
  • 财务: 模式文档、公司政策

适用于: 深入文档、API参考、数据库模式、全面指南或任何Claude在工作时应参考的详细信息。

重要: 保持参考 一层深 从SKILL.md - 不要嵌套参考超过一层。 Claude在直接从SKILL.md引用时读取完整文件，但可能仅预览嵌套参考。

对于大参考文件 (>100行): 在顶部包括目录，以便Claude在部分读取时理解可用信息。

TODO: 如果您的技能包括参考文档，在此列出:

使内容可grep:

要找到OAuth实现细节:
```bash
grep -i "oauth" references/authentication.md
```

assets/

文件不打算加载到上下文中，而是在Claude产生的输出中使用。

来自其他技能的示例:

  • 品牌样式: PowerPoint模板文件 (.pptx), 徽标文件
  • 前端构建器: HTML/React样板项目目录
  • 排版: 字体文件 (.ttf, .woff2)

适用于: 模板、样板代码、文档模板、图像、图标、字体或任何计划在最终输出中复制或使用的文件。

TODO: 如果您的技能包括资产，在此列出:

  • assets/example.txt - TODO: 描述此资产的用途

任何不需要的目录可以删除。 不是每个技能都需要所有三种类型的资源。

故障排除

TODO: 文档常见问题及解决方案:

问题: [常见问题]

  • 原因: TODO: 为什么这发生
  • 解决方案: TODO: 如何修复

问题: [另一个常见问题]

  • 原因: TODO: 为什么这发生
  • 解决方案: TODO: 如何修复

最佳实践

TODO: 列出使用此技能有效的建议:

  • TODO: 最佳实践1
  • TODO: 最佳实践2
  • TODO: 最佳实践3

版本历史

  • v1.0.0 (YYYY-MM-DD): 初始发布

模板使用指令

在部署此技能前，完成所有TODO项目:

  1. ✅ 替换 skill-name 在frontmatter中为实际名称 (小写、连字符、最大64字符)
  2. ✅ 编写具体 description 包含功能 AND 触发器场景 (最大1024字符)
  3. ✅ 替换所有TODO部分为实际内容
  4. ✅ 选择并实现 ONE 结构模式 (移除其他)
  5. ✅ 添加与您的技能相关的具体示例
  6. ✅ 文档任何支持文件 (脚本、参考、资产)
  7. ✅ 移除此 “模板使用指令” 部分
  8. ✅ 验证YAML frontmatter语法
  9. ✅ 测试技能激活与代表性查询
  10. ✅ 确保目录名称匹配 name 字段精确

结构模式选择:

  • 基于工作流: 顺序过程，有清晰步骤 (例如，设置工作流、多步骤操作)
  • 基于任务: 相关操作集合 (例如，PDF工具、API操作)
  • 基于参考: 标准和指南 (例如，品牌指南、编码标准)
  • 基于能力: 集成功能集 (例如，平台能力、产品功能)
  • 验证反馈循环: 需要正确性的操作，带中间验证

内容大小:

  • 官方指南: 保持低于500行或5k令牌以获得最佳性能
  • 目标: 2,000-5,000字在SKILL.md中
  • 最大: ~10,000字 - 如果超过，使用references/ 详细信息
  • 最小: ~500字 - 提供足够上下文
  • 如果接近限制，移动详细文档到references/
  • 保持此文件专注于基本指令

写作原则: “简洁是关键”

上下文窗口与对话历史、其他技能和用户请求共享。

  • 挑战每个解释: “Claude真的需要这个吗?”
  • 省略Claude已知的内容 (什么是PDFs，库做什么)
  • 专注于您的领域特定、要求和工作流
  • 示例: 不要解释OAuth是什么; 解释YOUR OAuth配置

设置适当的自由度:

匹配特定性到任务脆弱性:

  • 高自由 (文本指令): 多个有效方法、上下文依赖决策
  • 中自由 (伪代码/模板): 首选模式，可接受变化
  • 低自由 (精确脚本): 脆弱操作、一致性关键、特定顺序必需

描述提示:

关键: 总是使用第三人称 - 描述注入系统提示:

  • ✅ “处理Excel文件并生成报告”
  • ❌ “我可以帮助您处理Excel文件” (第一人称)
  • ❌ “您可以使用此来处理Excel文件” (第二人称)

包括这些关键词类型:

  • 文件类型: .md, .json, .xlsx, PDF, Excel
  • 领域: API, authentication, database, testing
  • 任务: analyze, generate, create, build, validate
  • 工具: Git, Docker, Kubernetes, PostgreSQL

官方模式: [它做什么]. 使用当 [特定触发器].

这是技能发现的唯一文档机制。 Claude使用描述从100+可用技能中选择。 包括 BOTH 能力 AND 触发器。

示例描述:

✅ 优秀 (遵循官方模式):

description: 分析Excel电子表格，生成透视表，创建图表。 使用当处理Excel文件 (.xlsx, .xls)、电子表格分析或数据可视化任务。

✅ 好 (清晰触发器):

description: 通过分析git差异生成描述性提交消息。 使用当编写提交消息、审查暂存更改或准备git提交时。

❌ 缺失 “使用当…” 触发器:

description: 生成描述性提交消息。

❌ 太模糊:

description: 帮助处理文件。

❌ 错误声音 (必须第三人称):

description: 我将帮助您分析电子表格。

验证检查清单:

  • [ ] YAML frontmatter有效
  • [ ] name 遵循约定 (小写、连字符、最大64字符)
  • [ ] name 匹配目录名称精确
  • [ ] description 遵循官方模式: [它做什么]. 使用当 [触发器].
  • [ ] description 包括 “使用当…” 带有特定触发器关键词
  • [ ] 所有TODO项目替换
  • [ ] 示例具体和代表性
  • [ ] 支持文件文档 (如果存在)
  • [ ] 技能激活为预期场景