为什么要创建 Claude Skills？

每个开发团队都有独特的工作流、约定和最佳实践。学习如何创建 Claude Skills 让您可以将这些编码为可复用、可分享的包，任何团队成员都可以激活。

创建 Claude Skills 的常见原因：

标准化团队工作流：创建确保每个人遵循相同流程的 Claude Skills
捕获机构知识：创建记录经验丰富的开发者隐性知识的 Claude Skills
自动化重复模式：创建将常见多步骤任务变成单个命令的 Claude Skills
与社区分享：创建 Claude Skills 帮助他人解决您已经解决的问题

Claude Skill 结构解析

创建 Claude Skills 时，每个本质上是一个具有特定结构的 markdown 文件。最小可行的 Claude Skill：

---
name: my-custom-skill
description: Brief description of what this skill does
---

# My Custom Skill

## When to Use

Use this skill when [specific trigger conditions].

## Workflow

1. Step one
2. Step two
3. Step three

## Rules

- Rule one
- Rule two

关键部分

Frontmatter

YAML frontmatter 定义元数据：

---
name: skill-name          # kebab-case 标识符
description: What it does  # 一行摘要
---

使用时机

清楚地定义触发条件。Claude 使用这个来决定何时激活 skill。

工作流

Claude 应该遵循的分步流程。

规则

Claude 必须遵循的硬性约束。

构建您的第一个 Claude Skill

让我们为一致的 API 端点开发创建一个 Claude Skill。

步骤 1：定义问题

在创建 Claude Skills 之前，确定您想标准化的重复模式。例如："每个 API 端点都需要输入验证、错误处理、日志记录和测试。"

步骤 2：编写 Claude Skill 文件

创建 api-endpoint-builder.md：

---
name: api-endpoint-builder
description: Build consistent API endpoints with validation, error handling, and tests
---

# API Endpoint Builder

## When to Use

Use when creating a new API endpoint or route handler.

## Workflow

1. Define the endpoint contract (method, path, input, output)
2. Create input validation schema
3. Write the route handler with error boundaries
4. Add structured logging
5. Write integration tests
6. Update API documentation

## Template

### Input Validation
Every endpoint must validate inputs before processing:

- Use Zod/Yup schemas for request body
- Validate path parameters
- Check required headers

### Error Handling
Wrap handler logic in try/catch:

- Return appropriate HTTP status codes
- Include error details in development
- Log errors with context

### Testing Checklist
- [ ] Happy path test
- [ ] Invalid input test
- [ ] Authentication test
- [ ] Rate limiting test

步骤 3：测试 Claude Skill

将 Claude Skill 放在您的 .claude/ 目录中并测试它。

步骤 4：完善

常见的改进：

添加更具体的示例
在 Claude 偏离的地方收紧规则
为复杂步骤添加检查清单
包含常见模式的代码模板

创建 Claude Skills 的高级模式

带强制的检查清单

## Checklist (MANDATORY - create TodoWrite for each item)

- [ ] Input validation schema created
- [ ] Error handling added
- [ ] Logging implemented
- [ ] Happy path test written
- [ ] Edge case tests written
- [ ] Documentation updated

条件逻辑

## Workflow

1. Determine the endpoint type:
   - **GET**: Skip input validation for body, focus on query params
   - **POST/PUT**: Full input validation required
   - **DELETE**: Validate permissions and ownership

Skill 组合

## Workflow

1. Use the **brainstorming** skill to define the endpoint contract
2. Use the **TDD** skill to implement with tests
3. Use the **code-review** skill to verify quality

发布您的 Claude Skills

在 Claude Skills Hub 上

创建 Claude Skills 后，与社区分享：

创建一个包含您的 Claude Skill 的 GitHub 仓库
添加带有使用说明的清晰 README
访问 Claude Skills Hub 并提交您的仓库
我们的团队会审查 Claude Skills 提交的质量和安全性

发布 Claude Skills 的要求

仓库必须是公开的
包含有效的 Claude Skill 定义文件
提供清晰的文档
没有恶意代码或有害模式
遵循安全最佳实践

创建出色 Claude Skills 的技巧

要具体：模糊的指令产生模糊的结果。告诉 Claude 确切要做什么。
包含示例：在您的 Claude Skills 中展示好的输出是什么样的。
添加防护栏：定义 Claude 不应该做什么，而不仅仅是应该做什么。
用边界情况测试：尝试不寻常的输入来发现 Claude Skills 中的差距。
迭代：Claude Skills 随时间改进。根据实际使用更新。

社区 Claude Skills 贡献

Claude Skills 生态系统因社区贡献而蓬勃发展。许多学习如何创建 Claude Skills 的开发者最终公开分享他们最好的作品——一些最受欢迎的 skills 最初是内部工具。

如果您知道如何创建解决常见问题的 Claude Skills，请考虑贡献。社区受益于多样的视角和真实世界的测试。

访问提交页面与世界分享您的 skills。

如何创建 Claude Skills：分步自定义 Skill 指南