# design

design is a Claude Code skill that turns requirements into design documents and task plans before coding begins. It can also resume a feature in docs/feat/wip/.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 155 repo stars
- Author: serpro69
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/serpro69/claude-toolbox/tree/HEAD/kodex-plugin/skills/design/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/serpro69-design

## What it does

design drafts technical designs, specifications, implementation plans, and task lists from an idea or a set of requirements. It loads the relevant workflow instructions and project guidance, then follows the process for either a new idea or an existing feature.

For ongoing work, the skill checks the feature materials in `docs/feat/wip/` and identifies what remains. After substantial edits, it suggests a separate `$kk:clarify-docs` step and then recommends `$kk:review-design`; it does not run either command. The workflow loads all applicable instructions before drafting begins.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add serpro69/claude-toolbox --skill design -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add serpro69/claude-toolbox --skill design -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add serpro69/claude-toolbox --skill design -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install serpro69/claude-toolbox kodex-plugin/skills/design
```

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

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add serpro69/claude-toolbox --skill design -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/serpro69/claude-toolbox --path kodex-plugin/skills/design
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/design/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/serpro69/claude-toolbox/tree/HEAD/kodex-plugin/skills/design/SKILL.md

## When to use it
- turn an idea into a technical design and specification
- break implementation work into a plan and task list
- resume a feature documented in `docs/feat/wip/`
- refine requirements before coding starts

## Example prompts
- Turn this idea into a technical design and task plan before coding starts.
- Continue the feature in `docs/feat/wip/` and identify the next tasks.
- Revise the specification and task list to reflect these requirements.

## Similar
- [design-brief](https://affpapa.org/en/nevibecode/skills/owl-listener-design-brief.md) — skill · 2500 installs
- [design-system-adoption](https://affpapa.org/en/nevibecode/skills/design-system-adoption.md) — skill · 2400 installs
- [ux-design](https://affpapa.org/en/nevibecode/skills/daveebbelaar-ux-design.md) — skill · 1000 installs
- [presentation-design](https://affpapa.org/en/nevibecode/skills/aaronvanston-presentation-design.md) — skill · 823 installs
- [presentation-design-enhancer](https://affpapa.org/en/nevibecode/skills/presentation-design-enhancer.md) — skill · 603 installs
- [production-design-direction](https://affpapa.org/en/nevibecode/skills/production-design-direction.md) — skill · 192 installs

## Other versions with the same name
- [design · nextlevelbuilder](https://affpapa.org/en/nevibecode/skills/design.md) — 52700 installs
- [design · subframeapp](https://affpapa.org/en/nevibecode/skills/subframeapp-design.md) — 798 installs
- [design · rshankras](https://affpapa.org/en/nevibecode/skills/rshankras-design.md) — 738 installs
- [design · cognitedata](https://affpapa.org/en/nevibecode/skills/cognitedata-design.md) — 1900 installs
- [design · kirkchen](https://affpapa.org/en/nevibecode/skills/kirkchen-design.md) — 523 installs

From the same set: [serpro69/claude-toolbox](https://affpapa.org/en/nevibecode/by/serpro69/claude-toolbox.md) — 30 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
