// 创建新的 Claude Code 技能，修改和优化已有技能。当用户想从头创建技能、将当前工作流封装为技能、优化已有技能的内容或触发描述时使用此技能。即使用户没有明确说"技能"，当他们想把某个重复工作流程固定下来时也应使用。
| name | skill-creator |
| description | 创建新的 Claude Code 技能，修改和优化已有技能。当用户想从头创建技能、将当前工作流封装为技能、优化已有技能的内容或触发描述时使用此技能。即使用户没有明确说"技能"，当他们想把某个重复工作流程固定下来时也应使用。 |
| allowed-tools | Read,Write,Bash |
帮助用户创建、修改和优化 Claude Code 技能。
~/.claude/skills/<skill-name>/ 目录按用户的实际需求灵活执行——可以跳过不需要的步骤。
SKILL.md 必须以 YAML frontmatter 开头。frontmatter 用 --- 行包裹，首行必须是 ---，不能有前导空行或空格。
---
name: my-skill-name
description: 技能功能描述，以及何时应当调用此技能
allowed-tools: Read,Write,Bash
---
严格要求：
---（三个连字符，无前导空格）---（独立一行）key: value| 字段 | 要求 | 说明 |
|---|---|---|
name | 必填 | 技能标识符。仅限小写字母、数字和连字符，最长 64 字符。不能以连字符开头或结尾。示例：code-reviewer、api-client-gen |
description | 必填 | 技能做什么 + 何时触发。最长 1024 字符。这是自动触发的唯一判断依据，必须写清楚触发场景 |
| 字段 | 说明 |
|---|---|
allowed-tools | 技能激活时允许使用的工具列表，逗号分隔。常用：Read、Write、Bash、Edit、Grep、Glob |
version | 版本号，如 1.0.0 |
合法：code-reviewer、api-gen、my-skill-2
非法：Code_Reviewer（大写和下划线）、-my-skill（连字符开头）、my skill（空格）
description 是技能能否被正确触发的关键。遵循以下原则：
先说做什么，再说何时用：生成 API 客户端代码。当用户需要根据 OpenAPI/Swagger 规范生成 HTTP 客户端、REST API 封装、或类型定义时使用。
包含用户可能使用的关键词：把用户自然语言中会用到的词写进去，即使不是技术术语。
适度"主动"：Claude 倾向于不触发技能，所以 description 应该稍微宽泛一些。例如，不要只写 处理 PDF 文件，而应写 处理 PDF 文件。当用户提到 PDF、文档转换、表格提取、文件合并、表单填写，或需要处理任何扫描文档时都应使用此技能。
不要在 description 中写使用说明：description 仅用于触发判断，具体指令放在正文中。
不好：你必须始终使用 TypeScript。绝对不允许使用 JavaScript。
好：使用 TypeScript 编写，因为项目需要类型安全来减少运行时错误。
Claude 已经知道如何编程、如何使用工具。不需要解释基础概念，只需要写：
如果技能有固定的输出格式，提供明确的模板：
## 输出格式
生成的报告必须使用以下结构：
# [标题]
## 摘要
## 发现
## 建议
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这些信息应由上层平台在保存、扫描、晋升或发布时自动补齐。
---
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 字符。
主文件 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 并验证：
---name 和 description 字段--- 是否独立成行处理基于 git 和 GitHub 的真实协作工作流。当任务涉及仓库同步、分支管理、修复 bug、提交代码、创建或更新 PR、处理 review、解决冲突、检查 GitHub 认证与权限、或需要通过 fork 与用户仓库协作时使用，强调安全、干净、可审计的协作流程。**必须在需要时使用该 Skill 并严格遵守相关规范!!!**
使用此技能进行浏览器自动化操作，包括网页抓取、表单填写、UI 测试和任何 Web 交互任务。