Claude Code skill-creator 使用

简介

skill-creator 是一个内置技能，专门用来快速生成新的 Skill（智能体技能）定义文件。
你只需要描述技能的用途、输入参数、执行步骤和输出规范，skill-creator 会自动生成符合规范的 .md 技能文件，保存到项目 .claude/skills/ 目录，省去手动编写技能模板的工作。

前置：项目存在 .claude/skills 目录；已加载 skill-creator 技能。

skill-creator 技能作用

根据自然语言需求，自动生成标准格式的 Skill Markdown 文件
自动填充：技能名称、描述、入参、执行步骤、输出约束
写入文件到 .claude/skills/[技能名].md
输出技能调用示例，方便直接使用

调用 skill-creator 基础语法

调用技能 skill-creator，创建新技能，需求：【在这里描述技能能力】

示例1：创建SQL审计技能

输入：

调用技能 skill-creator，创建新技能，需求：读取项目sql脚本，检查SQL注入风险、索引缺失、全表扫描问题，输出安全审计报告，只读，不修改文件。

skill-creator 会生成文件：.claude/skills/sql-audit.md，并输出调用示例。

示例2：创建Git变更摘要技能

输入：

调用技能 skill-creator，创建新技能，需求：读取git最近提交，对比diff，生成变更摘要，列出新增/修改文件，输出markdown变更报告，禁止修改代码。

skill-creator 可自定义参数

调用时可以追加参数，约束生成的技能：

skillName：指定技能名称（文件名）
params：定义输入参数
permission：权限约束（只读 / 允许修改文件）
outputFormat：输出格式（markdown表格 / 纯文本）

示例带参数调用：

调用技能 skill-creator，skillName=doc-generator，params=[sourceFile]，permission=只读，outputFormat=markdown，需求：读取源码文件，自动生成函数注释与API文档。

完整实操步骤

确认项目存在 .claude/skills 文件夹，没有就手动创建
在 Claude Code 会话调用 skill-creator，描述技能需求
skill-creator 生成技能md文件，保存至 .claude/skills/
重载技能配置：

/skill reload

使用 /skill list 查看，确认新技能加载成功
直接调用新生成的技能进行测试

常用配套命令

/skill list           # 列出所有技能，确认新建技能存在
/skill describe xxx   # 查看生成的技能完整定义
/skill reload         # 重载技能，新建/修改技能后执行

示例输出（skill-creator生成的 doc-generator.md）

# Skill：doc-generator
## 技能描述
读取源码文件，自动生成函数注释与API文档。## 输入参数
- sourceFile：源码文件路径
## 执行步骤
1. 读取 sourceFile 指定源码
2. 解析所有函数、接口、类型定义
3. 提取入参、返回值、业务功能
4. 生成Markdown格式文档与函数注释
## 约束
1. 只读文件，不修改源码
2. 文档简洁，贴合项目编码规范

技能组合使用示例

先用 skill-creator 创建代码漏洞扫描技能，然后直接调用：

调用技能 skill-creator，skillName=vuln-scan，params=[scanPath]，permission=只读，需求：扫描指定目录源码，查找前端XSS、后端输入校验漏洞，输出漏洞清单。调用技能 vuln-scan，scanPath=src/

最佳实践

使用 skill-creator 生成基础模板，后续手动微调约束、输出规则，提升技能质量
技能创建完成后，务必 /skill reload 重载
保持技能单一职责，一个技能只做一类任务
.claude/skills 提交Git，团队共享技能库

常见问题

调用 skill-creator 提示找不到该技能

确认项目已存在 skill-creator.md；
执行 /skill reload 重载；
检查文件路径 .claude/skills/skill-creator.md。

skill-creator 无法写入技能文件
检查项目目录读写权限，同时查看 .claude/rules 是否限制写入 .claude/skills。
生成的技能规则不符合预期
调用时增加更详细约束描述；生成后手动编辑md文件，再重载技能。

安全提示

skill-creator 具备新建/修改 .claude/skills 目录文件能力，生产环境使用 Manual 模式，审核文件变更。

简介