Skip to main content
skill CX Codex

web-design — Claude Code skill: what it does, how to install

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

no license 192 installs ★ 102 updated 2026-09-11

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add pascalorg/skills --skill web-design -a claude-code
Open on GitHub

What web-design 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.

What it helps with

  • 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 for the agent

  • 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

How to install web-design

1Skills CLI (Vercel)

npx skills add pascalorg/skills --skill web-design -a claude-code

2Manually: put the files in place

~/.claude/skills/web-design/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/web-design/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about web-design

How do I install web-design in Claude Code?

Run npx skills add pascalorg/skills --skill web-design -a claude-code. The skill lands at ~/.claude/skills/web-design/SKILL.md.

What does web-design do?

Feeds the agent a design reference covering layout, type, color, component states, motion and accessibility. The agent consults it while building or reviewing a UI.

Does it work with Codex or Cursor?

Yes. Codex: npx skills add pascalorg/skills --skill web-design -a codex; Cursor takes the same command ending in -a cursor. Copilot uses gh skill install pascalorg/skills web-design.

Similar skills

All skills for Design →

From the same set4

Project sponsors

Companies that keep this analytics open