# skill-creator

Walks you through building a new skill or reworking an old one: what belongs in SKILL.md, what goes into scripts and references.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1100 installs · ★ 444
- Author: aiskillstore
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/aiskillstore/marketplace/tree/HEAD/skills/skill-creator/SKILL.md
- Updated: 2026-10-25
- HTML: https://affpapa.org/en/nevibecode/skills/aiskillstore-skill-creator

## What it does

This skill is a set of rules for writing instructions an agent will follow. The core idea: skip anything the model already knows. Only guidance that changes its decisions earns a place in `SKILL.md`.

The layout is folder-based. `SKILL.md` is required and carries `name` and `description` in its frontmatter; `scripts/`, `references/`, `assets/` and `agents/openai.yaml` are optional. How much detail you write depends on the risk. Where several approaches make sense, leave the choice open. Fixed step sequences belong to fragile operations only. Long procedures, schemas and examples are meant to live in `references/`, not in the entrypoint.

Scope gets its own section. Approval to do a job does not widen that job or grant rights to touch anything outside it, and retrying or mutating workflows need a stopping condition set in advance. Without one, a skill starts editing neighbouring files and configs.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add aiskillstore/marketplace --skill skill-creator -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add aiskillstore/marketplace --skill skill-creator -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add aiskillstore/marketplace --skill skill-creator -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install aiskillstore/marketplace skill-creator
```

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

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add aiskillstore/marketplace --skill skill-creator -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/aiskillstore/marketplace --path skills/skill-creator
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add aiskillstore/marketplace --skill skill-creator -a opencode
```

### 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/aiskillstore/marketplace/tree/HEAD/skills/skill-creator/SKILL.md

## When to use it
- draft a new skill the agent will actually route to
- move lengthy procedures out of `SKILL.md` into `references/`
- strip generic advice the model already has
- set a stopping condition for retrying or mutating workflows
- sort a skill's files into `scripts/`, `references/` and `assets/`

## Example prompts
- Create a skill for our database migrations and tell me what goes in `SKILL.md` versus `references/`
- Rewrite this skill's `SKILL.md`: drop the generic advice, keep only what changes your decisions
- Add a script under `scripts/` for the repeated step and describe when to run it

## Similar
- [harness-creator](https://affpapa.org/en/nevibecode/skills/harness-creator.md) — skill · 2400 installs
- [bmad-prfaq](https://affpapa.org/en/nevibecode/skills/bmad-prfaq.md) — skill · 11300 installs
- [bmad-customize](https://affpapa.org/en/nevibecode/skills/bmad-customize.md) — skill · 11200 installs
- [printing-press-output-review](https://affpapa.org/en/nevibecode/skills/printing-press-output-review.md) — skill · 6400 installs
- [k-skill-cleaner](https://affpapa.org/en/nevibecode/skills/k-skill-cleaner.md) — skill · 6100 installs
- [skill-progressive-disclosure-design](https://affpapa.org/en/nevibecode/skills/skill-progressive-disclosure-design.md) — skill · 4300 installs

## Other versions with the same name
- [skill-creator · anthropics](https://affpapa.org/en/nevibecode/skills/skill-creator.md) — 414180 installs
- [skill-creator · openclaw](https://affpapa.org/en/nevibecode/skills/openclaw-skill-creator.md) — 6700 installs
- [skill-creator · openai](https://affpapa.org/en/nevibecode/skills/openai-skill-creator.md) — 4900 installs
- [skill-creator · langchain-ai](https://affpapa.org/en/nevibecode/skills/langchain-ai-skill-creator.md) — 1300 installs
- [skill-creator · tldraw](https://affpapa.org/en/nevibecode/skills/tldraw-skill-creator.md) — 431 installs

---
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