designing-beautiful-websites — Claude Code skill for UX/UI work
A skill for planning, building and reviewing web interfaces: page structure, responsive behaviour, visual language and interaction states.
npx skills add tristanmanchester/agent-skills --skill designing-beautiful-websites -a claude-codeWhat designing-beautiful-websites does
The skill starts by reading the request, the existing code, the design system and the content on hand. It works out who the user is, what the page is for, which journey matters, and what constraints apply. A small polish request stays small unless a structural problem blocks the result. A new site gets a chosen direction and an actual deliverable, not just a planning document.
Reference files load one at a time depending on the task: typography and composition, navigation and structure, controls and forms, labels and microcopy, content-led responsive layouts, accessibility checks, an audit format, page patterns. An optional contrast helper for opaque-sRGB needs Python 3.9+. Design reasoning runs on supplied content and screenshots; implementation and browser verification depend on what the project already has. Without a browser environment the agent cannot confirm keyboard or screen-reader behaviour, and the skill says a screenshot is not a substitute for that.
Some things are ruled out on purpose. No invented client logos, reviews, awards or statistics to fill a layout. No fake scarcity. No hiding important content behind a JavaScript reveal that may fail. Placeholder content gets marked as such. Restyling keeps refs, focus, validation and form submission intact, and a control that looks disabled still has to behave correctly.
What it helps with
- plan page structure around real content
- work out responsive behaviour for narrow screens and zoom
- define loading, error and empty states
- run an interface audit with locations and impact
- move forms and dialogs onto semantic patterns with focus handling
Example prompts for the agent
- Build the pricing page from this mockup and show where it breaks at 360 px
- Audit the signup form: where does focus get lost and which errors are unclear
- Rework the dashboard navigation while keeping the current component system
How to install designing-beautiful-websites
1Skills CLI (Vercel)
npx skills add tristanmanchester/agent-skills --skill designing-beautiful-websites -a claude-code2Manually: put the files in place
~/.claude/skills/designing-beautiful-websites/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/designing-beautiful-websites/
1Skills CLI (Vercel)
npx skills add tristanmanchester/agent-skills --skill designing-beautiful-websites -a codex2Manually: put the files in place
.agents/skills/designing-beautiful-websites/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add tristanmanchester/agent-skills --skill designing-beautiful-websites -a cursor2Manually: put the files in place
.cursor/skills/designing-beautiful-websites/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install tristanmanchester/agent-skills designing-beautiful-websites2Manually: put the files in place
.github/skills/designing-beautiful-websites/SKILL.md1Skills CLI (Vercel)
npx skills add tristanmanchester/agent-skills --skill designing-beautiful-websites -a gemini-cli2Platform CLI
gemini skills install https://github.com/tristanmanchester/agent-skills --path designing-beautiful-websitesManually: put the files in place
.devin/skills/designing-beautiful-websites/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add tristanmanchester/agent-skills --skill designing-beautiful-websites -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 designing-beautiful-websites
How do I install designing-beautiful-websites in Claude Code?
Run npx skills add tristanmanchester/agent-skills --skill designing-beautiful-websites -a claude-code. The skill file then sits at ~/.claude/skills/designing-beautiful-websites/SKILL.md.
What does designing-beautiful-websites do?
It guides the agent through designing, implementing and critiquing interfaces: information structure, user journeys, responsive layouts, visual systems, copy and interaction states.
Does this skill need Python?
Only the optional opaque-sRGB contrast helper does — it requires Python 3.9+. The rest of the references work without it.