一、什么是 skill-creator？

skill-creator 是 Anthropic 官方推出的元技能（meta-skill），核心定位是「技能工厂」—— 它能帮你快速创建、测试、评估和迭代优化 Claude Code 的专属技能，将零散的提示词工程升级为系统化的「技能工程」流程。

它不是简单的模板生成器，而是提供了完整的技能研发闭环：

• 需求定义 → 技能设计 → 代码实现 → 评估测试 → 性能优化 → 发布使用
• 内置量化评估系统，支持并行测试与描述调优，确保技能触发精准、执行可靠

---

二、安装指南（三种方法，按需选择）

2.1 官方市场安装（推荐）

这是最稳定、最便捷的安装方式，适合大多数用户：

# 1. 启动 Claude Code
claude

# 2. 添加官方插件市场（首次安装）
/plugin marketplace add anthropics/skills

# 3. 安装 skill-creator
/plugin install skill-creator@anthropics/skills

# 4. 验证安装
/plugin list  # 查看已安装插件
/skill        # 查看技能菜单，确认 skill-creator 已加载

2.2 社区市场安装（备选）

如果官方市场不可用，可使用 daymade 社区市场：

# 添加社区市场
/plugin marketplace add daymade/claude-code-skills

# 安装 skill-creator
/plugin install skill-creator@daymade-skills

2.3 本地手动安装（开发/离线场景）

适合需要修改源码或离线使用的开发者：

# 1. 克隆官方技能仓库
git clone https://github.com/anthropics/claude-plugins-official.git

# 2. 创建技能目录
mkdir -p ~/.claude/skills/

# 3. 复制 skill-creator 到技能目录
cp -r claude-plugins-official/plugins/skill-creator/skills/skill-creator ~/.claude/skills/

# 4. 重启 Claude Code
/exit
claude

三、核心使用场景

skill-creator 适用于任何需要重复执行且有固定流程的工作场景，以下是高频应用场景：

3.1 开发效率提升

• API接口生成器：自动根据 Swagger 文档生成 TypeScript 类型定义、axios 请求函数和错误处理逻辑
• PR代码审查助手：按团队规范自动检查代码格式、安全性问题和性能瓶颈
• 数据库迁移工具：自动生成 SQL 迁移脚本并验证数据一致性

3.2 内容创作自动化

• 技术博客生成器：按固定模板生成包含代码块、图表和引用格式的技术文章
• 微信公众号写作助手：根据主题生成符合公众号风格的文章，自动添加小标题和图片建议
• 文档翻译工具：保持原文格式，批量翻译技术文档并验证术语一致性

3.3 运维与DevOps

• 部署前检查器：自动执行环境验证、配置核对和健康检查，确保部署成功率
• 日志分析工具：解析复杂日志，提取关键信息并生成可视化报告
• 服务器监控仪表盘：自动收集服务器指标，生成自定义监控报告

3.4 个人效率工具

• 待办事项管理器：按优先级自动分类任务，生成每日计划
• 学习笔记整理器：将零散笔记结构化，生成思维导图和复习计划
• 会议纪要生成器：自动提取会议录音关键信息，生成结构化纪要

---

四、实战Demo：打造「Java后端API文档生成器」技能

下面通过完整流程演示如何使用 skill-creator 创建一个实用技能，解决「重复编写Java API文档」的痛点。

4.1 启动技能创建流程

在 Claude Code 中输入：

/skill use skill-creator
创建一个Java后端API文档生成器技能，要求：
1. 输入Java Controller代码，自动生成Swagger风格的API文档
2. 支持RESTful风格接口，包含请求参数、响应格式和错误码
3. 输出Markdown格式，可直接用于项目README

4.2 交互式需求定义

skill-creator 会引导你完成需求细化：

> 请确认技能名称（建议简洁明了）：java-api-doc-generator
> 请补充技能描述（用于触发匹配）：根据Java Controller代码生成Swagger风格API文档
> 请指定允许使用的工具（用逗号分隔）：read,write
> 请描述核心工作流程（分步骤）：
  1. 读取用户提供的Java Controller代码文件
  2. 解析类注释、方法注释和参数注释
  3. 提取RESTful接口信息（请求方法、路径、参数、响应）
  4. 生成符合Swagger规范的Markdown文档
  5. 保存文档到用户指定路径
> 请设置评估标准（用于测试技能效果）：
  - 文档覆盖率：100%覆盖所有接口方法
  - 格式正确性：符合Swagger规范，可直接导入Swagger UI
  - 可读性：包含示例请求和响应，便于理解

4.3 技能生成与初步测试

skill-creator 自动生成完整的技能包，包含：

• java-api-doc-generator/SKILL.md：技能核心定义文件
• java-api-doc-generator/scripts/parser.py：Java代码解析脚本
• java-api-doc-generator/references/swagger-spec.md：Swagger规范参考

生成的 SKILL.md 核心内容：

---
name: java-api-doc-generator
description: 根据Java Controller代码生成Swagger风格API文档
allowed-tools: read,write
user-invocable: true
---
# Java后端API文档生成器

## 工作流程
1. 读取用户提供的Java Controller文件路径
2. 调用parser.py脚本解析代码结构
3. 提取RESTful接口信息（@RestController、@RequestMapping等注解）
4. 解析Javadoc注释，生成接口描述、参数说明和响应示例
5. 按Swagger规范生成Markdown文档
6. 保存文档到用户指定路径

## 输出格式
```markdown
# API文档：[Controller名称]

## 基础路径
[basePath]

## 接口列表
| 接口名称 | 请求方法 | 路径 | 描述 |
|----------|----------|------|------|
| [methodName] | [HTTP Method] | [path] | [description] |

### 请求参数
| 参数名 | 类型 | 是否必填 | 描述 |
|--------|------|----------|------|
| [paramName] | [type] | [required] | [description] |

### 响应格式
| 字段名 | 类型 | 描述 |
|--------|------|------|
| [fieldName] | [type] | [description] |

4.4 技能评估与迭代优化

skill-creator 内置评估系统，可自动测试技能效果：

skill-creator 内置评估系统，可自动测试技能效果：

评估 java-api-doc-generator 技能，使用测试用例：
测试文件：UserController.java（包含3个接口：getUserById、createUser、deleteUser）

**评估结果：**

✅ 文档覆盖率：100%（3/3接口）
✅ 格式正确性：通过Swagger UI验证
⚠️ 可读性：缺少错误码说明，建议补充
⚠️ 性能：解析大型文件（>1000行）时耗时较长，建议优化解析算法

根据评估结果，使用 skill-creator 进行迭代优化：

/skill use skill-creator
优化 java-api-doc-generator 技能：

1. 添加错误码说明部分，解析@ApiResponse注解
2. 优化parser.py脚本，使用AST解析代替正则表达式，提升性能
3. 增加接口分组功能，按业务模块分类

4.5 最终使用

优化完成后，使用技能生成API文档：

/skill java-api-doc-generator