# design-review

design-review is a Claude Code skill that critiques interfaces across ten dimensions and gives exact fixes. It can apply safe changes to code.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 836 installs · ★ 39 repo stars
- Author: Superfuture
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Superfuture/design-review/tree/HEAD/design-review/skills/design-review/SKILL.md
- Updated: 2026-08-20
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/superfuture-design-review

## What it does

The skill reviews an interface the way a senior designer would. It takes a screenshot, a component file, or a URL, then checks hierarchy, typography, spacing rhythm, color and contrast, motion, component states, responsiveness, accessibility, and brand consistency. For URLs it fetches markup and CSS through WebFetch, which returns text rather than a render — a screenshot is still needed for visual judgement.

Findings are grouped by severity: blocking, important, and polish. Each one states the specific issue, why it matters, and a concrete fix with exact values instead of vague advice. The report ends with two to four strengths and, when useful, the single change that would improve the most.

With `--apply`, the skill edits code for clear, safe findings: contrast, spacing, focus states, reduced motion, semantic tags, alt text. Subjective or structural changes stay as recommendations. A Pro mode adds SwiftUI mobile patterns and brand-token consistency, served by a paid license-gated endpoint — those findings are never fabricated locally.

## Install

### Claude Code (native platform)

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Superfuture/design-review design-review/skills/design-review
```

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

### Gemini CLI

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

2. **Platform CLI**
```bash
gemini skills install https://github.com/Superfuture/design-review --path design-review/skills/design-review
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add Superfuture/design-review --skill design-review -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/Superfuture/design-review/tree/HEAD/design-review/skills/design-review/SKILL.md

## When to use it
- catch blocking accessibility issues before release
- check contrast ratios and tap-target sizes with actual numbers
- get fixes with exact values instead of general advice
- apply safe code edits automatically
- review a screen across ten criteria without reading a checklist manually

## Example prompts
- Review this screenshot: check typography, spacing, and contrast.
- Check Button.tsx before release, especially accessibility and states.
- Review the page at this URL and tell me what blocks shipping. Here is a desktop screenshot.

## Similar
- [frontend-design](https://affpapa.org/en/nevibecode/skills/sickn33-frontend-design.md) — skill · 2700 installs
- [design-review-process](https://affpapa.org/en/nevibecode/skills/design-review-process.md) — skill · 2400 installs
- [designing-beautiful-websites](https://affpapa.org/en/nevibecode/skills/designing-beautiful-websites.md) — skill · 2800 installs
- [design-brief](https://affpapa.org/en/nevibecode/skills/design-brief.md) — skill · 5500 installs
- [ui-design](https://affpapa.org/en/nevibecode/skills/mindrally-ui-design.md) — skill · 1000 installs
- [awesome-design-md](https://affpapa.org/en/nevibecode/skills/awesome-design-md.md) — skill · 1100 installs

## Other versions with the same name
- [design-review · nexu-io](https://affpapa.org/en/nevibecode/skills/nexu-io-design-review.md) — 3400 installs
- [design-review · donchitos](https://affpapa.org/en/nevibecode/skills/donchitos-design-review.md) — 774 installs
- [design-review · julianoczkowski](https://affpapa.org/en/nevibecode/skills/design-review.md) — 6100 installs
- [design-review · plugin87](https://affpapa.org/en/nevibecode/skills/plugin87-design-review.md) — 694 installs
- [design-review · jezweb](https://affpapa.org/en/nevibecode/skills/jezweb-design-review.md) — 1500 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
