# web-design

The web-design skill gives an agent a web design reference in four priority tiers. It is read before the agent works on UI.

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

## What it does

The skill puts a web design reference into the agent's context. Material comes from Refactoring UI, Tailwind CSS, shadcn/ui, Laws of UX, Every Layout and similar write-ups, split into twenty sections: spacing, type, color, shadows, hierarchy, motion, components, responsive behaviour, accessibility, performance, UX psychology, design tokens, microcopy, defensive CSS, a modern reset, prefetching, audio feedback. One section deals with the visual tells of generated UI and how to remove them.

Work runs in four tiers. Semantic markup, grid and responsive sizing come first. Color, contrast and component states next. Keyboard access, transitions and animation after that. Shadows, optical tweaks and micro-interactions last. The order matters: a page that breaks at 768px does not need a shadow opacity debate, and the skill sends you back to tier one.

The file has to sit where the agent looks for it. On Claude Code that is `~/.claude/skills/web-design/SKILL.md`, on Cursor `.cursor/skills/web-design/SKILL.md`. Install with `npx skills add`.

## Install

### Claude Code (native platform)

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install pascalorg/skills web-design
```

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

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

## When to use it
- set a spacing scale instead of ad-hoc pixel values
- pick a type scale, line height and measure
- get text and UI contrast to WCAG AA
- cover hover, focus-visible, disabled and empty states on every control
- strip the tells of generated UI such as gratuitous gradients

## Example prompts
- Build the pricing page in web-design order: semantic markup and grid first, colors and shadows after
- Audit this form against the web-design checklist and list what breaks tier one
- Pick dark-mode design tokens using the color section of web-design

## Similar
- [modern-web-design](https://affpapa.org/en/nevibecode/skills/modern-web-design.md) — skill · 3200 installs
- [premium_web_design](https://affpapa.org/en/nevibecode/skills/jerrar670-premium-web-design.md) — skill · 252 installs
- [web-typography](https://affpapa.org/en/nevibecode/skills/web-typography.md) — skill · 9900 installs
- [generic-design-system](https://affpapa.org/en/nevibecode/skills/generic-design-system.md) — skill · 143 installs
- [neobrutalist-web-designer](https://affpapa.org/en/nevibecode/skills/neobrutalist-web-designer.md) — skill · 279 installs
- [premium-web-design](https://affpapa.org/en/nevibecode/skills/premium-web-design.md) — skill · 1090 installs

From the same set: [pascalorg/skills](https://affpapa.org/en/nevibecode/by/pascalorg/skills.md) — 4 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
