skill-creator

SKILL.md

Skill Creator

一个专业级的 Skill 创建工具,帮助用户设计和实现自定义的 Claude Code Skill。

功能特点

  • 多模板支持:提供 8 种常见 Skill 模板,覆盖文档处理、数据分析、浏览器操作等多个领域
  • 引导式创建:分步骤引导用户确认所有关键信息,确保创建的 Skill 结构完整
  • 完整输出:自动生成 Skill 目录结构、SKILL.md、README.md 等全部必要文件
  • 最佳实践:遵循 Claude Code Skill 设计规范,确保创建的 Skill 可直接使用

工作流

当用户请求创建新的 Skill 时,按照以下步骤执行:

Step 1:欢迎与确认基本信息

向用户致以欢迎,并开始收集基础信息:

欢迎使用 Skill Creator!

我将帮助您创建一个全新的 Claude Code Skill。为了确保创建出高质量的 Skill,
请允许我询问几个关键问题。

首先,请提供以下基础信息:
1. Skill 的名称(英文,使用连字符分隔,如:document-processor)
2. 一句话描述这个 Skill 的功能
3. 您的姓名/昵称(作为作者署名)

如果用户已经准备好基本信息,可以直接进入下一步;否则引导用户提供。

Step 2:选择 Skill 类型模板

根据用户需求,推荐最适合的模板类型。展示可用的模板选项:

可用的模板类型:

模板名称 适用场景 复杂度 说明
文档处理类 PDF/Word/Excel 处理、内容提取、格式转换 中等 适合文件操作和文档处理场景
数据分析类 数据统计、可视化、报表生成 中等 适合数据处理和分析场景
浏览器操作类 网页导航、表单填写、截图采集 较高 适合 Web 自动化场景
内容创作类 写作辅助、翻译、文档生成 简单 适合内容创作和文案场景
外部服务集成类 API 调用、第三方服务对接 较高 适合外部服务集成场景
通用工具类 文件操作、系统命令、工具调用 简单 适合通用工具场景
代码开发类 代码生成、重构、审查、调试 中等 适合软件开发场景
自定义模板 特殊需求、未涵盖的场景 可变 完全自定义的 Skill 结构

询问用户:

  • 「您希望创建哪种类型的 Skill?(请选择上述模板类型之一,或描述您的特殊需求)」

Step 3:确认功能范围与复杂度

根据选择的模板类型,深入了解用户需求:

对于文档处理类 Skill:

  • 需要处理哪些文档格式?(PDF/Word/Excel/PPT/其他)
  • 主要功能是什么?(读取/写入/转换/分析/提取)
  • 是否有特定的输出格式要求?

对于数据分析类 Skill:

  • 数据来源是什么?(文件/数据库/API/用户输入)
  • 需要哪些分析类型?(统计/趋势/聚类/预测/可视化)
  • 输出形式是什么?(报告/图表/数据导出)

对于浏览器操作类 Skill:

  • 需要执行哪些操作?(导航/点击/填写/截图/抓取)
  • 目标网站是否有登录要求?(是/否)
  • 是否需要处理动态内容?(是/否,需要等待)

对于内容创作类 Skill:

  • 主要创作类型是什么?(文章/报告/邮件/社交媒体/其他)
  • 是否需要模板支持?(是/否)
  • 目标受众是谁?

对于外部服务集成类 Skill:

  • 需要集成哪些服务?(请描述)
  • 认证方式是什么?(API Key/OAuth/其他)
  • 调用的频率和并发需求如何?

对于通用工具类 Skill:

  • 主要功能类别是什么?(文件/系统/网络/其他)
  • 目标用户是谁?(开发者/设计师/普通用户)
  • 是否需要配置文件?

对于代码开发类 Skill:

  • 编程语言是什么?(单选或多选)
  • 开发阶段是什么?(编码/测试/调试/审查/文档)
  • 是否需要集成版本控制?

对于自定义模板:

  • 请详细描述您需要的 Skill 功能
  • 是否需要参考现有模板?
  • 有没有特定的文件结构要求?

Step 4:定义工作流程

根据收集的信息,与用户确认 Skill 的工作流程:

标准工作流结构示例:

工作流程框架(将根据模板类型调整):

1. 输入接收
   - 接收用户的请求参数
   - 验证输入的有效性
   - 解析并标准化输入数据

2. 核心处理
   - 执行主要业务逻辑
   - 调用必要的工具和 API
   - 处理各种边界情况

3. 结果处理
   - 格式化输出结果
   - 验证输出质量
   - 处理错误和异常

4. 输出呈现
   - 返回处理结果
   - 提供附加信息(如适用)
   - 给出使用建议

与用户确认:

  • 「以上工作流程是否符合您的需求?如果需要调整,请告诉我具体要求。」

Step 5:确认输出文件结构

确认用户希望生成的文件结构:

标准 Skill 目录结构:

skill-name/
├── SKILL.md           # 主 Skill 文件(必需)
├── README.md          # 说明文档(推荐)
├── LICENSE.txt        # 许可证文件(推荐)
└── references/        # 参考资料目录(可选)
    └── templates/     # 模板文件(根据需要)

询问用户:

  • 您希望生成哪些文件?
    • SKILL.md(必需)- 主文件
    • README.md(推荐)- 说明文档
    • LICENSE.txt(可选)- 许可证
    • references/(可选)- 参考资料目录

Step 6:生成 Skill 文件

根据收集的所有信息,生成完整的 Skill 文件:

6.1 生成 SKILL.md

使用模板生成主文件,格式如下:

---
name: [skill-name]
description: [一句话描述]
license: LICENSE-CC-BY-NC-SA 4.0 in LICENSE.txt
author: [作者名]
---

# Skill Name

[Skill 的详细描述和功能说明]

## 使用场景

[描述在什么情况下应该使用此 Skill]

## 前置条件

[使用此 Skill 前需要满足的条件,如:安装特定工具、配置 API 密钥等]

## 工作流

[详细的工作流程说明,包含步骤和子步骤]

## 输入参数

[描述 Skill 接受的输入参数及其格式]

## 输出格式

[描述 Skill 的输出格式]

## 使用示例

[提供几个使用示例]

## 注意事项

[使用此 Skill 时需要注意的事项]

## 错误处理

[可能出现的错误及处理方式]

6.2 生成 README.md

# Skill Name

[一句话描述]

## 简介

[详细介绍 Skill 的功能、用途和特点]

## 功能特性

- 功能点 1
- 功能点 2
- ...

## 快速开始

[简要的使用指南]

## 详细文档

请参阅 [SKILL.md](SKILL.md) 获取完整文档。

## 许可证

本项目采用 CC BY-NC-SA 4.0 许可证。

6.3 生成 LICENSE.txt

使用 CC BY-NC-SA 4.0 许可证模板。

6.4 生成 references 目录(如需要)

根据模板类型,生成相应的参考资料。

Step 7:展示与确认

向用户展示生成的 Skill 文件内容:

  1. 展示文件目录结构
  2. 展示 SKILL.md 完整内容
  3. 展示 README.md 完整内容(如生成)
  4. 询问用户是否有修改需求

示例输出:

✅ Skill 创建完成!

📁 目录结构:
├── my-skill/
│   ├── SKILL.md
│   ├── README.md
│   └── LICENSE.txt

📄 SKILL.md 预览:
[内容展示]

请确认以上内容是否符合您的需求。如需修改,请告诉我具体调整。

Step 8:迭代优化

根据用户反馈进行迭代:

  • 收集用户的修改意见
  • 调整相应文件内容
  • 重新展示确认
  • 重复直到用户满意

Step 9:完成与使用指导

确认完成后,提供使用指导:

🎉 Skill 创建完成!

您的 Skill 已准备就绪。以下是使用指南:

1. 将 my-skill/ 目录放置到您的 Claude Code Skills 目录中
2. 在 Claude Code 中加载此 Skill
3. 开始使用!

如需进一步定制,请随时告诉我。

模板参考

所有模板的详细说明和示例请参阅 references/templates/ 目录:

模板文件 适用场景
01_document_processing.md 文档处理类 Skill
02_data_analysis.md 数据分析类 Skill
03_browser_operation.md 浏览器操作类 Skill
04_content_creation.md 内容创作类 Skill
05_external_service.md 外部服务集成类 Skill
06_utility_tool.md 通用工具类 Skill
07_code_development.md 代码开发类 Skill
08_custom_template.md 自定义模板

最佳实践

文件命名规范

  • 使用小写字母和连字符
  • 避免使用空格和特殊字符
  • 保持简洁且具有描述性

描述编写规范

  • 一句话描述:简洁明了,不超过 20 个字
  • 详细描述:说明功能、用途、特点

工作流设计原则

  • 步骤清晰,每个步骤有明确的目标
  • 考虑边界情况和错误处理
  • 保持合理的粒度,不过于复杂也不过于简单

代码质量

  • 使用清晰的注释
  • 遵循单一职责原则
  • 保持代码简洁可读

常见问题

Q:创建的 Skill 可以直接使用吗? A:是的,按照本工具生成的 Skill 结构完整,可以直接放入 Claude Code 的 Skills 目录中使用。

Q:可以修改生成的模板吗? A:当然可以。在 Step 7 展示文件内容后,您可以要求任何修改。

Q:如何添加自定义模板? A:您可以在 references/templates/ 目录下添加新的模板文件,并在 SKILL.md 中更新模板列表。

Q:生成的 Skill 如何分发? A:您可以将整个 Skill 目录打包分享,其他用户只需将其放入自己的 Skills 目录即可使用。

扩展功能

如需以下扩展功能,请提出您的需求:

  • 批量创建多个相关 Skill
  • 从现有 Skill 派生新模板
  • 导入/导出 Skill 配置
  • 集成版本控制
  • 自动测试生成
Weekly Installs
185
GitHub Stars
10
First Seen
Jan 22, 2026
Installed on
codex172
opencode172
gemini-cli169
github-copilot165
amp162
kimi-cli162