Skill Creator
JUJING-DEEP/skill-creator
Crie Skills para Claude com processo estruturado e validação
Ver no GitHubGuia completo para criar Claude Skills profissionais, do conceito até a distribuição empacotada. Oferece um processo estruturado em seis etapas (entender requisitos, planejar conteúdo, inicializar, editar, empacotar e iterar) com validação de qualidade e suporte a recursos bundled.
Instalação
npx convez-ai JUJING-DEEP/skill-creator1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Criar Skills modulares para estender capacidades do Claude
- Empacotar workflows especializados e conhecimento de domínio
- Distribuir skills através do protocolo Agent Skills aberto
- Automatizar processos repetitivos com scripts e assets bundled
Veredito

Framework sólido e bem documentado para criar e distribuir Skills do Claude, com foco em simplicidade e reuso. Recomendado para quem quer modularizar soluções e compartilhar expertise através de Skills reutilizáveis em 50+ runtimes compatíveis.
README
A tradução para o português deste README ainda está na fila.
Skill Creator
创建有效的 Claude Skills 指南 — 从概念到打包分发。
创建 Skills 的完整指南 — 模块化、自包含的包,扩展 Claude 的能力。
基于开放的 Agent Skills 协议,可在 Claude Code、Codex、Cursor、OpenClaw、Hermes Agent、CodeBuddy、Workbuddy、Gemini CLI、OpenCode 等 50+ 兼容 runtime 中运行。
功能演示 · 安装 · 使用方法 · 工作原理 · 项目结构
功能演示
用户 ❯ 帮我创建一个新的 Skill
Claude ❯ 使用 Skill Creator 开始创建...
❯ 理解需求 → 规划内容 → 初始化 → 编辑 → 打包
❯ ✅ Skill 创建完成!
用户 ❯ /skill add JUJING-DEEP/skill-creator
Claude ❯ Skill 已安装,可以开始创建新技能了
Skill Creator 能做什么:
- 🎯 专业化流程 — 六步流程,从需求理解到打包分发
- 📦 bundled Resources — 支持 scripts/、references/、assets/ 组织结构
- ✨ 渐进式披露 — 上下文高效的三级加载系统
- 🔍 质量验证 — 打包前自动检查
工作原理
Skill 是什么
Skills 是模块化、自包含的包,通过以下方式扩展 Claude 的能力:
- 专业化工作流 — 特定领域的多步骤流程
- 工具集成 — 处理特定文件格式或 API 的说明
- 领域专业知识 — 公司知识、schemas、业务逻辑
- 捆绑资源 — 脚本、参考资料、复杂重复任务的资产
创建流程
Step 1: 理解需求 → Concrete Examples
↓
Step 2: 规划内容 → Scripts / References / Assets
↓
Step 3: 初始化 → init_skill.py
↓
Step 4: 编辑 → 实现资源和编写 SKILL.md
↓
Step 5: 打包 → package_skill.py
↓
Step 6: 迭代 → 基于实际使用改进
核心原则
简洁是关键
上下文窗口是公共资源。Skills 与其他内容共享上下文窗口:系统提示、对话历史、其他 Skills 的元数据以及实际用户请求。
默认假设:Claude 已经非常聪明。 只添加 Claude 确实需要的内容。
设置适当的自由度
根据任务的脆弱性和可变性匹配特异性级别:
| 级别 | 类型 | 适用场景 |
|---|---|---|
| 高自由度 | 文本指令 | 多种方法有效、依赖上下文 |
| 中等自由度 | 伪代码/脚本 | 首选模式存在、一些变化可接受 |
| 低自由度 | 特定脚本 | 操作脆弱、一致性关键 |
安装
Skill Creator 基于开放的 Agent Skills 协议,可在任何 skills-compatible 的 AI agent runtime 中运行。
方式一:一行命令(推荐,跨 runtime)
打开你正在用的 agent(Claude Code、Codex、Cursor、OpenClaw、Hermes、CodeBuddy、Workbuddy、Gemini CLI、OpenCode 等),告诉它:
帮我安装这个 skill:https://github.com/JUJING-DEEP/skill-creator
或者用通用 CLI 安装器(vercel-labs/skills,支持 55+ runtime):
npx skills add JUJING-DEEP/skill-creator
方式二:手动安装
| Runtime | 安装路径 |
|---|---|
| Claude Code | ~/.claude/skills/skill-creator/ |
| Codex CLI | ~/.codex/skills/skill-creator/ |
| Cursor | ~/.cursor/skills/skill-creator/ |
| OpenClaw | ~/.openclaw/workspace/skills/skill-creator/ |
| Hermes Agent | 跑 tools/install_hermes_skill.py |
| 其他 runtime | clone 到对应 runtime 的 skills/ 目录 |
git clone https://github.com/JUJING-DEEP/skill-creator <上面对应的路径>
使用方法
基本用法
帮我创建一个新的 skill
创建流程
- 理解需求 — 明确 Skill 的使用场景
- 规划内容 — 确定需要哪些 scripts、references、assets
- 初始化 — 运行
init_skill.py <skill-name> --path <output-directory> - 编辑 — 编写 SKILL.md 和相关资源
- 打包 — 运行
package_skill.py <path/to/skill-folder> - 迭代 — 基于实际使用改进
SKILL.md 结构
---
name: skill-name
description: 当用户想...时使用此 Skill
---
# Skill Name
## 职责
[简述 Skill 做什么]
## 执行流程
[详细步骤]
## 质量检查
[自检清单]
项目结构
skill-creator/
├── SKILL.md # 本 Skill 的核心逻辑
├── README.md # 本文档
├── LICENSE # MIT 许可证
└── assets/ # 演示动画
└── demo.gif
生成的 Skill 结构
使用 init_skill.py 初始化后,新 Skill 会有以下结构:
skill-name/
├── SKILL.md # 核心技能定义
├── README.md # 项目文档
├── scripts/ # 可执行脚本
│ ├── init_skill.py # 初始化脚本
│ └── package_skill.py # 打包脚本
├── references/ # 参考文档
│ └── workflow.md # 工作流指南
└── assets/ # 资产文件
└── template/ # 模板文件
质量检查清单
生成 Skill 后,检查以下项目:
- YAML frontmatter 格式正确(name + description)
- SKILL.md 简洁明了(<500 行)
- 所有代码块有语言标注
- 参考资料在 references/ 目录(不在 SKILL.md 重复)
- 打包后 validation 通过
关于
Skill Creator 是创建 Claude Skills 的完整指南。它提供:
- 清晰的理解需求的方法
- 高效规划 Skill 内容的框架
- 初始化和打包的工具
- 渐进式披露设计原则
- 质量验证检查清单
许可证
MIT — 随便用,随便改,随便分发。
MIT License © JUJING-DEEP
English
A comprehensive guide for creating effective Claude Skills — from concept to packaged distribution.
Skill Creator is an Agent Skill that provides the complete guide for creating Claude Skills. Works in Claude Code, Codex, Cursor, OpenClaw, Hermes Agent, CodeBuddy, Workbuddy, Gemini CLI, OpenCode, and 50+ skills-compatible runtimes.
Install (cross-runtime, auto-detects your agent): npx skills add JUJING-DEEP/skill-creator
Usage:
Create a new skill for me
The skill guides you through: understanding requirements → planning contents → initializing → editing → packaging → iterating.