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
npx skills add pascalorg/skills --skill web-design -a claude-codeWhat 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-code2Manually: put the files in place
~/.claude/skills/web-design/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/web-design/
1Skills CLI (Vercel)
npx skills add pascalorg/skills --skill web-design -a codex2Manually: put the files in place
.agents/skills/web-design/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add pascalorg/skills --skill web-design -a cursor2Manually: put the files in place
.cursor/skills/web-design/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install pascalorg/skills web-design2Manually: put the files in place
.github/skills/web-design/SKILL.md1Skills CLI (Vercel)
npx skills add pascalorg/skills --skill web-design -a gemini-cli2Platform CLI
gemini skills install https://github.com/pascalorg/skills --path web-designManually: put the files in place
.devin/skills/web-design/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add pascalorg/skills --skill web-design -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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.