| name | skill-creator |
| description | 创建新的 Claude Code 技能，修改和优化已有技能。当用户想从头创建技能、将当前工作流封装为技能、优化已有技能的内容或触发描述时使用此技能。即使用户没有明确说"技能"，当他们想把某个重复工作流程固定下来时也应使用。 |
| allowed-tools | Read,Write,Bash |
技能创建器
帮助用户创建、修改和优化 Claude Code 技能。
核心流程
- 理解用户意图（想让技能做什么、何时触发、期望输出）
- 编写符合规范的 SKILL.md
- 保存到
~/.claude/skills/<skill-name>/ 目录
- 验证技能可被正确解析
按用户的实际需求灵活执行——可以跳过不需要的步骤。
SKILL.md 格式规范（必须严格遵守）
Frontmatter 格式
SKILL.md 必须以 YAML frontmatter 开头。frontmatter 用 --- 行包裹，首行必须是 ---，不能有前导空行或空格。
---
name: my-skill-name
description: 技能功能描述，以及何时应当调用此技能
allowed-tools: Read,Write,Bash
---
严格要求：
- 第一行必须是
---（三个连字符，无前导空格）
- 最后一行必须是
---（独立一行）
- 每个字段占一行，格式为
key: value
- 冒号后必须有一个空格
- 值中不要使用引号包裹，除非值本身包含特殊字符
- frontmatter 与正文之间应有一个空行
必填字段
| 字段 | 要求 | 说明 |
|---|
name | 必填 | 技能标识符。仅限小写字母、数字和连字符，最长 64 字符。不能以连字符开头或结尾。示例：code-reviewer、api-client-gen |
description | 必填 | 技能做什么 + 何时触发。最长 1024 字符。这是自动触发的唯一判断依据，必须写清楚触发场景 |
可选字段
| 字段 | 说明 |
|---|
allowed-tools | 技能激活时允许使用的工具列表，逗号分隔。常用：Read、Write、Bash、Edit、Grep、Glob |
version | 版本号，如 1.0.0 |
name 字段规则
合法：code-reviewer、api-gen、my-skill-2
非法：Code_Reviewer（大写和下划线）、-my-skill（连字符开头）、my skill（空格）
description 字段写法指南
description 是技能能否被正确触发的关键。遵循以下原则：
-
先说做什么，再说何时用：生成 API 客户端代码。当用户需要根据 OpenAPI/Swagger 规范生成 HTTP 客户端、REST API 封装、或类型定义时使用。
-
包含用户可能使用的关键词：把用户自然语言中会用到的词写进去，即使不是技术术语。
-
适度"主动"：Claude 倾向于不触发技能，所以 description 应该稍微宽泛一些。例如，不要只写 处理 PDF 文件，而应写 处理 PDF 文件。当用户提到 PDF、文档转换、表格提取、文件合并、表单填写，或需要处理任何扫描文档时都应使用此技能。
-
不要在 description 中写使用说明：description 仅用于触发判断，具体指令放在正文中。
正文编写原则
用祈使句，解释原因而非堆砌规则
不好：你必须始终使用 TypeScript。绝对不允许使用 JavaScript。
好：使用 TypeScript 编写，因为项目需要类型安全来减少运行时错误。
保持简洁，仅写 Claude 不知道的内容
Claude 已经知道如何编程、如何使用工具。不需要解释基础概念，只需要写：
- 项目特有的约定和模式
- 需要遵循的特定工作流程
- 预期的输出格式（如有要求）
输出格式用模板定义
如果技能有固定的输出格式，提供明确的模板：
## 输出格式
生成的报告必须使用以下结构：
# [标题]
## 摘要
## 发现
## 建议
控制在 500 行以内
SKILL.md 正文应控制在 500 行以内。超过时，将详细内容拆分到附属文件。
多文件技能结构
复杂技能应拆分为多个文件：
my-skill/
├── SKILL.md # 主文件（核心指令，保持简洁）
├── reference.md # 参考文档（按需加载）
├── examples.md # 示例（按需加载）
└── scripts/
└── helper.py # 可执行脚本（直接运行，无需加载到上下文）
在 SKILL.md 中明确引用附属文件，告诉 Claude 什么时候该读取它们：
## 参考资料
- 完整 API 文档见 [reference.md](reference.md)
- 使用示例见 [examples.md](examples.md)
平台元数据边界
只创建和修改 skill 内容文件，例如 SKILL.md、install.md、reference.md、scripts/。
不要手动编造或维护平台级来源元数据，例如：
.skill-origin.json- 市场/社区 skill ID
- 发布者身份
- 工作区实例 ID
这些信息应由上层平台在保存、扫描、晋升或发布时自动补齐。
完整示例
示例 1：简单技能
---
name: commit-message
description: 生成规范的 Git 提交信息。当用户完成代码修改想要提交、需要写 commit message、或提到 conventional commits 时使用。
allowed-tools: Read,Bash
---
根据暂存区的变更生成提交信息。
## 流程
1. 运行 `git diff --cached --stat` 查看变更概览
2. 运行 `git diff --cached` 查看具体变更
3. 分析变更的性质（新功能、修复、重构等）
4. 生成符合 Conventional Commits 格式的提交信息
## 提交信息格式
类型(范围): 简要描述
- feat: 新功能
- fix: 修复
- refactor: 重构
- docs: 文档
- test: 测试
- chore: 构建/工具
范围是可选的，用于标识影响的模块。描述用祈使语气，不超过 72 字符。
示例 2：多文件技能
主文件 SKILL.md：
---
name: api-client-gen
description: 根据 OpenAPI 规范生成类型安全的 API 客户端代码。当用户需要生成 HTTP 客户端、REST API 封装、SDK、或从 Swagger/OpenAPI 文档创建类型定义时使用。
allowed-tools: Read,Write,Bash
---
根据 OpenAPI/Swagger 规范生成类型安全的 API 客户端。
## 流程
1. 读取用户提供的 OpenAPI 规范文件
2. 分析 endpoints、schemas 和认证方式
3. 根据目标语言生成客户端代码
4. 包含类型定义、错误处理和认证逻辑
## 支持的语言
根据项目上下文自动检测，或由用户指定。
参考各语言的具体模板见 [reference.md](reference.md)。
保存位置
将技能保存到 ~/.claude/skills/<skill-name>/ 目录：
mkdir -p ~/.claude/skills/my-skill-name
workspace 本地技能在会话之间持久保存，创建后即可被 Claude Code 发现。
创建后验证
技能创建完成后，读取生成的 SKILL.md 并验证：
- 第一行是否为
---
- frontmatter 中是否包含
name 和 description 字段
- name 是否符合命名规则（小写字母、数字、连字符）
- description 是否清晰描述了功能和触发场景
- 第二个
--- 是否独立成行
- frontmatter 之后是否有正文内容
