# create-skill

create-skill guides Claude Code through building a skill or slash command by clarifying its purpose and activation scenarios. Use it to draft a new instruction file.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 276 repo stars
- Author: Samarth Gupta
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/gupsammy/Claudest/tree/HEAD/plugins/claude-skills/skills/create-skill/SKILL.md
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/samarth-gupta-create-skill

## What it does

The skill gathers the goal, trigger scenarios, inputs and outputs, complexity, and execution needs. If the request lacks detail, it asks follow-up questions; the goal and trigger scenarios are enough to begin drafting.

It then prepares YAML frontmatter and the file body, and tests whether the description covers intended prompts without matching nearby cases. For a new directory, it runs `init_skill.py` and reads `frontmatter-options.md` before writing the frontmatter. Creating that directory uses Python 3 and `${CLAUDE_PLUGIN_ROOT}`. A naming collision returns exit code 1, so choose another name or confirm an overwrite.

## Install

### Claude Code (native platform)

1. **Plugin marketplace**
In the agent chat (not a shell):
```text
/plugin marketplace add gupsammy/Claudest
```
In the agent chat (not a shell):
```text
/plugin install claude-skills@Claudest
```
This installs the whole claude-skills plugin with all its skills

2. **Skills CLI (Vercel)**
```bash
npx skills add gupsammy/Claudest --skill create-skill -a claude-code
```

3. **Manually: put the files in place**
- File: `~/.claude/skills/create-skill/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/create-skill/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add gupsammy/Claudest --skill create-skill -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/create-skill/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add gupsammy/Claudest --skill create-skill -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/create-skill/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install gupsammy/Claudest plugins/claude-skills/skills/create-skill
```

2. **Manually: put the files in place**
- File: `.github/skills/create-skill/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add gupsammy/Claudest --skill create-skill -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/gupsammy/Claudest --path plugins/claude-skills/skills/create-skill
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/create-skill/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/gupsammy/Claudest/tree/HEAD/plugins/claude-skills/skills/create-skill/SKILL.md

## When to use it
- turn a goal and trigger scenarios into a skill
- draft a slash command with a concise description
- write YAML frontmatter for an instruction file
- check which prompts should activate a skill
- initialize a skill directory with resources and examples

## Example prompts
- Create a database migration review skill; ask me about its purpose and trigger scenarios first.
- Draft a `release-notes` slash command that prepares release notes.
- Initialize a skill named `api-audit` under `plugins` with `scripts,references` resources.

## Similar
- [create-tooluniverse-skill](https://affpapa.org/en/nevibecode/skills/create-tooluniverse-skill.md) — skill · 416 installs
- [create-prd](https://affpapa.org/en/nevibecode/commands/create-prd.md) — command · 2431 installs
- [create-plugin](https://affpapa.org/en/nevibecode/commands/create-plugin.md) — command · ★ 47914 repo stars
- [workflow-skill-creator](https://affpapa.org/en/nevibecode/skills/workflow-skill-creator.md) — skill · 2600 installs
- [skill-creator](https://affpapa.org/en/nevibecode/skills/sickn33-skill-creator.md) — skill · 988 installs
- [skillify](https://affpapa.org/en/nevibecode/skills/coreyhaines31-skillify.md) — skill · 384 installs

## Other versions with the same name
- [create-skill · neolabhq](https://affpapa.org/en/nevibecode/skills/neolabhq-create-skill.md) — 1300 installs
- [create-skill · siviter-xyz](https://affpapa.org/en/nevibecode/skills/create-skill.md) — 2800 installs
- [create-skill · sethgammon](https://affpapa.org/en/nevibecode/skills/sethgammon-create-skill.md) — ★ 937 repo stars
- [create-skill · aeonfun](https://affpapa.org/en/nevibecode/skills/aeonfun-create-skill.md) — ★ 797 repo stars
- [create-skill · thedesignproject](https://affpapa.org/en/nevibecode/skills/thedesignproject-create-skill.md) — ★ 107 repo stars

From the same set: [gupsammy/claudest](https://affpapa.org/en/nevibecode/by/gupsammy/claudest.md) — 47 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
