skill-creator

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Skill Creator

Create modular Agent Skills that extend Claude's capabilities. Skills package expertise into discoverable folders containing instructions, scripts, and resources.

创建可扩展Claude能力的模块化Agent Skills。技能将专业知识打包到包含说明、脚本和资源的可发现文件夹中。

When to Use

适用场景

"Create a skill for..."
"Make a new skill"
"Add a skill that..."
"How do I create a skill?"
"Document this workflow as a skill"

"为……创建技能"
"创建新技能"
"添加具备……功能的技能"
"如何创建技能？"
"将此工作流记录为技能"

Quick Start: Create a Skill

快速开始：创建技能

1. Choose Location

1. 选择存储位置

bash

undefined

bash

undefined

Personal skill (all projects)

个人技能（适用于所有项目）

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

Project skill (shared via git)

项目技能（通过Git共享）

mkdir -p .claude/skills/my-skill

undefined

mkdir -p .claude/skills/my-skill

undefined

2. Create SKILL.md

2. 创建SKILL.md文件

markdown

---
name: my-skill
description: Brief description of what it does and when to use it.
---

markdown

---
name: my-skill
description: 简要说明技能的功能及适用场景。
---

My Skill

我的技能

Instructions

操作说明

Step-by-step guidance for Claude.

给Claude的分步指导。

Examples

示例

Concrete usage examples.

undefined

具体使用示例。

undefined

3. Test It

3. 测试技能

Ask Claude a question that matches your description. Skills activate automatically based on context.

向Claude提出符合你技能描述的问题。技能会根据上下文自动激活。

SKILL.md Structure

SKILL.md 文件结构

Required: YAML Frontmatter

必填：YAML 头部信息

yaml

---
name: lowercase-with-hyphens    # Max 64 chars, [a-z0-9-] only
description: What it does AND when to use it. Include trigger keywords.
---

Critical: The

description

field determines when Claude discovers and uses your skill.

yaml

---
name: lowercase-with-hyphens    # 最多64个字符，仅允许[a-z0-9-]
description: 说明技能功能及适用场景，包含触发关键词。
---

关键提示：

description

字段决定了Claude何时发现并使用你的技能。

Optional: Tool Permissions

可选：工具权限

yaml

---
name: safe-reader
description: Read-only file access. Use for code review without modifications.
allowed-tools: Read, Grep, Glob
---

When

allowed-tools

is set, Claude can only use those tools without asking permission.

yaml

---
name: safe-reader
description: 只读文件访问权限。用于无需修改的代码审查场景。
allowed-tools: Read, Grep, Glob
---

当设置

allowed-tools

后，Claude只能使用指定的工具，无需额外询问权限。

Content Sections

内容章节

markdown

undefined

markdown

undefined

Skill Name

技能名称

Brief overview.

简要概述。

Prerequisites

前置条件

Installation or setup if needed.

所需的安装或设置步骤。

CLI Reference

CLI 参考

Commands with examples.

带示例的命令。

Common Workflows

常见工作流

Step-by-step procedures.

分步操作流程。

Best Practices

最佳实践

Guidelines and tips.

---

指南和技巧。

---

Skill Types

技能类型

Type	Location	Scope	Shared
Personal	`~/.claude/skills/`	All your projects	No
Project	`.claude/skills/`	This repo	Yes (git)
Plugin	Via installed plugins	Per plugin	Via marketplace

类型	存储位置	适用范围	是否可共享
个人技能	`~/.claude/skills/`	所有项目	否
项目技能	`.claude/skills/`	当前仓库	是（通过Git）
插件技能	通过已安装的插件	单个插件	是（通过市场）

Supporting Files

支持文件

Add files alongside SKILL.md:

my-skill/
├── SKILL.md           # Required
├── reference.md       # Optional docs
├── examples/          # Optional examples
├── scripts/           # Optional utilities
│   └── helper.ts
└── templates/         # Optional templates

Reference from SKILL.md:

markdown

See [reference.md](reference.md) for details.

Run the helper:
` ` `bash
bun scripts/helper.ts
` ` `

Claude reads supporting files only when needed (progressive disclosure).

可在SKILL.md旁添加以下文件：

my-skill/
├── SKILL.md           # 必填文件
├── reference.md       # 可选文档
├── examples/          # 可选示例
├── scripts/           # 可选工具脚本
│   └── helper.ts
└── templates/         # 可选模板

在SKILL.md中引用支持文件：

markdown

详情请查看[reference.md](reference.md)。

运行辅助脚本：
```bash
bun scripts/helper.ts


Claude仅在需要时读取支持文件（渐进式披露）。

---

Writing Good Descriptions

撰写优质描述

Bad (too vague):

yaml

description: Helps with data

Good (specific triggers):

yaml

description: Analyze Excel spreadsheets, create pivot tables, generate charts. Use when working with Excel files, .xlsx format, or spreadsheet analysis.

Include:

What the skill does
When to use it
Key trigger words users might say

反面示例（过于模糊）：

yaml

description: 处理数据相关工作

正面示例（包含具体触发词）：

yaml

description: 分析Excel电子表格、创建数据透视表、生成图表。适用于处理Excel文件、.xlsx格式或电子表格分析场景。

描述需包含：

技能核心功能
具体适用场景
用户可能使用的关键触发词

Complete Example

完整示例

Create

~/.claude/skills/api-testing/SKILL.md

创建

~/.claude/skills/api-testing/SKILL.md

markdown

---
name: api-testing
description: Test REST APIs with curl and analyze responses. Use when testing endpoints, debugging APIs, or validating HTTP requests.
---

markdown

---
name: api-testing
description: 使用curl测试REST API并分析响应。适用于测试接口、调试API或验证HTTP请求场景。
---

API Testing

API 测试

Test and debug REST APIs from the command line.

从命令行测试和调试REST API。

Prerequisites

前置条件

`bash

bash

undefined

Verify curl is available

验证curl是否可用

curl --version

undefined

CLI Reference

CLI 参考

Basic Requests

基础请求

bash curl -X GET "https://api.example.com/users" curl -X POST "https://api.example.com/users" \   -H "Content-Type: application/json" \   -d '{"name": "John"}'

bash

curl -X GET "https://api.example.com/users"
curl -X POST "https://api.example.com/users" \
  -H "Content-Type: application/json" \
  -d '{"name": "John"}'

With Authentication

带认证的请求

bash curl -H "Authorization: Bearer $TOKEN" \   "https://api.example.com/protected"

bash

curl -H "Authorization: Bearer $TOKEN" \
  "https://api.example.com/protected"

Save Response

保存响应结果

bash curl -o response.json "https://api.example.com/data"

bash

curl -o response.json "https://api.example.com/data"

Common Workflows

常见工作流

Test Endpoint Health

测试接口健康状态

`bash

bash

undefined

Check status code

检查状态码

curl -s -o /dev/null -w "%{http_code}" https://api.example.com/health

Measure response time

测量响应时间

curl -w "Time: %{time_total}s\n" -o /dev/null -s https://api.example.com

curl -w "耗时: %{time_total}s\n" -o /dev/null -s https://api.example.com

undefined

Best Practices

最佳实践

Use -s for scripts - Silent mode hides progress
Use -f to fail - Exit non-zero on HTTP errors
Use jq for JSON - Pipe to
```
jq
```
for pretty output

---

脚本中使用-s参数 - 静默模式隐藏进度信息
使用-f参数触发失败 - HTTP错误时返回非零退出码
使用jq处理JSON - 管道输出到
```
jq
```
实现格式化展示

---

Validation Checklist

验证 checklist

Troubleshooting

故障排除

Claude doesn't use my skill

Claude未使用我的技能

Description too vague - Add specific trigger keywords
Wrong location - Check path exactly matches conventions
Invalid YAML - Validate frontmatter syntax
Restart needed - Restart Claude Code after changes

描述过于模糊 - 添加具体的触发关键词
存储位置错误 - 检查路径是否完全符合规范
YAML语法无效 - 验证头部信息的语法正确性
需要重启 - 修改后重启Claude Code

Check skill loads

检查技能是否加载

bash

undefined

bash

undefined

Verify file exists

验证文件是否存在

cat ~/.claude/skills/my-skill/SKILL.md

List all skills

列出所有技能

ls ~/.claude/skills//SKILL.md ls .claude/skills//SKILL.md

undefined

ls ~/.claude/skills//SKILL.md ls .claude/skills//SKILL.md

undefined

Debug frontmatter

调试头部信息

bash

undefined

bash

undefined

View first 10 lines

查看前10行内容

head -n 10 ~/.claude/skills/my-skill/SKILL.md


Ensure:
- Opening `---` on line 1
- Closing `---` before content
- No tabs (use spaces)
- Strings with special chars are quoted

---

head -n 10 ~/.claude/skills/my-skill/SKILL.md


需确保：
- 开头的`---`在第1行
- 结尾的`---`在内容之前
- 不使用制表符（用空格代替）
- 包含特殊字符的字符串需加引号

---

Study Existing Skills

参考现有技能

bash

undefined

bash

undefined

See all personal skills

查看所有个人技能

ls ~/.claude/skills/*/SKILL.md

skill-creator

Original

Translation

Skill Creator

Skill Creator

When to Use

适用场景

Quick Start: Create a Skill

快速开始：创建技能

1. Choose Location

1. 选择存储位置

Personal skill (all projects)

个人技能（适用于所有项目）

Project skill (shared via git)

项目技能（通过Git共享）

2. Create SKILL.md

2. 创建SKILL.md文件

My Skill

我的技能

Instructions

操作说明

Examples

示例

3. Test It

3. 测试技能

SKILL.md Structure

SKILL.md 文件结构

Required: YAML Frontmatter

必填：YAML 头部信息

Optional: Tool Permissions

可选：工具权限

Content Sections

内容章节

Skill Name

技能名称

Prerequisites

前置条件

CLI Reference

CLI 参考

Common Workflows

常见工作流

Best Practices

最佳实践

Skill Types

技能类型

Supporting Files

支持文件

Writing Good Descriptions

撰写优质描述

Complete Example

完整示例

Create ~/.claude/skills/api-testing/SKILL.md

创建~/.claude/skills/api-testing/SKILL.md

API Testing

API 测试

Prerequisites

前置条件

Verify curl is available

验证curl是否可用

CLI Reference

CLI 参考

Basic Requests

基础请求

With Authentication

带认证的请求

Save Response

保存响应结果

Common Workflows

常见工作流

Test Endpoint Health

测试接口健康状态

Check status code

检查状态码

Measure response time

测量响应时间

Best Practices

最佳实践

Validation Checklist

验证 checklist

Troubleshooting

Create
`~/.claude/skills/api-testing/SKILL.md`

创建
`~/.claude/skills/api-testing/SKILL.md`