# review-design

review-design is a Claude Code skill that checks design documents before implementation begins. It runs after $kk:design and reviews all documents by default.

- 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/review-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/review-design

## What it does

review-design checks documents for completeness, clarity, and consistency, then assesses technical risks, edge cases, and testing plans. It serves as a review gate between design work and implementation. Findings include severity levels and next steps.

Standard mode reviews documents in the main conversation in a single pass. Isolated mode adds an internal sub-agent and external reviews. Its `pal clink` route requires a PAL build whose `listmodels` reports CLI client observations. If one reviewer fails, the others continue; if all fail, the skill suggests standard mode as a fallback.

## Install

### Claude Code (native platform)

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

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

### Codex

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

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

### Cursor

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

2. **Manually: put the files in place**
- File: `.cursor/skills/review-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/review-design
```

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/review-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/review-design/SKILL.md

## When to use it
- spot contradictions across design documents
- find requirements that lack implementation detail
- identify technical risks and overlooked edge cases
- sort review findings by severity

## Example prompts
- Review the design documents before implementation starts.
- Find gaps and conflicting requirements in the feature documents.
- Run an isolated design review before implementation.

## Similar
- [design-review](https://affpapa.org/en/nevibecode/skills/design-review.md) — skill · 6100 installs
- [ui-design-review](https://affpapa.org/en/nevibecode/skills/ui-design-review.md) — skill · 1200 installs
- [flows-design-review](https://affpapa.org/en/nevibecode/skills/flows-design-review.md) — skill · 1100 installs
- [design-review-garrytan](https://affpapa.org/en/nevibecode/skills/design-review-garrytan.md) — skill · 221 installs
- [review-design-parity](https://affpapa.org/en/nevibecode/commands/review-design-parity.md) — command · ★ 8052 repo stars
- [steve-jobs-design-review](https://affpapa.org/en/nevibecode/skills/steve-jobs-design-review.md) — skill · 3800 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
