# skill-creation

skill-creation converts past session breakthroughs into reusable agent skills inside SKILL.md files. Helps extract repeatable patterns and refine existing instructions.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 142 installs · ★ 129 repo stars
- Author: Factory-AI
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Factory-AI/factory-plugins/tree/HEAD/plugins/droid-evolved/skills/skill-creation/SKILL.md
- Updated: 2026-10-25
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/skill-creation

## What it does

The skill captures successful problem-solving paths from agent sessions and turns them into standalone `SKILL.md` documents. Each file starts with YAML metadata containing its name and trigger criteria. A precise description is critical here because the agent relies on it when picking which skill to trigger for an incoming prompt.

Skills are organized on two levels. Shared project playbooks go into `.factory/skills/` and get checked into version control. User-specific workflows stay in `~/.factory/skills/`. The skill prompts you to include verification steps and explicit failure boundaries. Without automated verification checks, an agent cannot validate its own output.

To spot recurring bottlenecks, you can inspect JSONL session archives with `rg`. Breaking changes to inputs or outputs warrant a major version increment.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add Factory-AI/factory-plugins --skill skill-creation -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add Factory-AI/factory-plugins --skill skill-creation -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add Factory-AI/factory-plugins --skill skill-creation -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Factory-AI/factory-plugins plugins/droid-evolved/skills/skill-creation
```

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

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add Factory-AI/factory-plugins --skill skill-creation -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/Factory-AI/factory-plugins --path plugins/droid-evolved/skills/skill-creation
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add Factory-AI/factory-plugins --skill skill-creation -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/Factory-AI/factory-plugins/tree/HEAD/plugins/droid-evolved/skills/skill-creation/SKILL.md

## When to use it
- extract solved session problems into reusable `SKILL.md` guides
- locate recurring errors across JSONL session logs with `rg`
- establish project-wide conventions inside `.factory/skills/`
- revise outdated agent instructions with new version tags

## Example prompts
- Extract the debugging steps from this session into a fresh skill
- Update the deployment skill with verification steps and common edge cases
- Inspect recent session logs to find repeated failures and improve the skill

## Similar
- [firestore-rules-creation](https://affpapa.org/en/nevibecode/skills/firestore-rules-creation.md) — skill · 36600 installs
- [ionic-app-creation](https://affpapa.org/en/nevibecode/skills/ionic-app-creation.md) — skill · 1300 installs
- [openspec-proposal-creation](https://affpapa.org/en/nevibecode/skills/openspec-proposal-creation.md) — skill · 1200 installs
- [user-guide-creation](https://affpapa.org/en/nevibecode/skills/user-guide-creation.md) — skill · 765 installs
- [Hedera Policy Creation](https://affpapa.org/en/nevibecode/skills/hedera-policy-creation.md) — skill · 613 installs
- [Hedera Hook Creation](https://affpapa.org/en/nevibecode/skills/hedera-hook-creation.md) — skill · 612 installs

From the same set: [factory-ai/factory-plugins](https://affpapa.org/en/nevibecode/by/factory-ai/factory-plugins.md) — 17 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
