如果你正在构建你的第一个技能，请从最佳实践指南开始，然后根据需要参考 API 文档。

官方文档

Anthropic 资源：

• 最佳实践指南
• 技能文档
• API 参考
• MCP 文档

博客文章:

• 介绍 Agent Skills
• 工程博客: 为现实世界装备 Agents
• Skills 详解
• 如何为 Claude 创建 Skills
• 为 Claude Code 构建 Skills
• 通过 Skills 改进前端设计

示例技能

公共技能仓库：

• GitHub: anthropics/skills
• 包含你可以自定义的 Anthropic 创建的技能

工具和实用程序

skill-creator skill：

• 内置于 Claude.ai 并可用于 Claude Code
• 可根据描述生成 skill
• 审查并提供建议
• 使用："Help me build a skill using skill-creator"

验证:

• skill-creator可以评估你的技能
• 询问:"评审这个技能并提出改进建议"

获取支持

技术问题：

• 一般问题：Claude Developers Discord 的社区论坛

对于错误报告:

• GitHub Issues: anthropics/skills/issues
• 包括:技能名称、错误信息、重现步骤

参考 A: 快速检查清单

使用此检查清单在上传前后验证你的 skill。如果你想更快地开始，使用 skill-creator skill 生成你的第一个草稿，然后核对此列表以确保你没有遗漏任何内容。

开始之前

☐ 确定了2-3个具体的用例 ☐ 确定了工具（内置或MCP） ☐ 审阅了本指南和示例技能 ☐ 规划了文件夹结构

开发期间

☐ 文件夹使用kebab-case命名 ☐ 存在SKILL.md文件(拼写准确) ☐ YAML前置数据有---分隔符 ☐ name字段:kebab-case，无空格，无大写字母 ☐ description包含功能说明和使用场景 ☐ 任何地方都没有XML标签(< >) ☐ 指令清晰且可执行 ☐ 包含错误处理 ☐ 提供示例 ☐ 引用链接清晰

上传前

☐ 测试了在明显任务上的触发 ☐ 测试了在改述请求上的触发 ☐ 验证了不会在无关主题上触发 ☐ 功能测试通过 ☐ 工具集成正常工作（如适用） ☐ 压缩为 .zip 文件

上传后

☐ 在真实对话中测试 ☐ 监控触发不足/过度触发的情况 ☐ 收集用户反馈 ☐ 迭代描述和指令 ☐ 更新元数据中的版本

参考 B: YAML 前置数据

必需字段

---
name: skill-name-in-kebab-case
description: 它做什么以及何时使用它。包括具体的触发短语。
---

所有可选字段

name: skill-name
description: [必需的描述]
license: MIT # 可选：开源许可证
allowed-tools: "Bash(python:*) Bash(npm:*) WebFetch" # 可选：限制工具访问
metadata: # 可选：自定义字段
author: Company Name
version: 1.0.0
mcp-server: server-name
category: productivity
tags: [project-management, automation]
documentation: https://example.com/docs
support: support@example.com

安全注意事项

允许的：

• 任何标准 YAML 类型（字符串、数字、布尔值、列表、对象）
• 自定义元数据字段
• 长描述（最多 1024 个字符）

禁止：

• XML 尖括号 (< >) - 出于安全考虑
• 在 YAML 中执行代码 (使用安全的 YAML 解析)
• 以"claude"或"anthropic"为前缀命名的技能 (系统保留)

参考 C: 完整的技能示例

以下是展示本指南中各种模式的完整、可用于生产环境的技能：

• Document Skills - PDF、DOCX、PPTX、XLSX 创建
• Example Skills - 各种工作流模式
• Partner Skills Directory - 查看来自 Asana、Atlassian、Canva、Figma、Sentry、Zapier 等各个合作伙伴的技能

这些代码仓库持续更新，并包含本指南涵盖范围之外的更多示例。你可以克隆它们，根据自己的用例进行修改，并将它们用作模板。