Give your coding agent design systems, UI and UX guidance, icons, and code reviews through MCP.
Works with Codex, Claude Code, Cursor, VS Code, Devin, Antigravity, and other MCP clients.
Website · Docs · Design systems · Installation guide
Install
Run these commands in your project:
npx skills add marvkr/better-design --skill better-design
npx better-design
The first installs the agent skill. The second connects Better Design to your coding tools and keeps your existing configuration. Restart your agent after setup.
If you have no account, setup creates a free key for you. If something does not work, run npx better-design doctor. It prints the command that fixes each problem.
What it does
When your agent builds UI, Better Design gives it what it usually misses:
| Tool | What your agent gets |
|---|---|
find-design-system |
A design system that fits the product you describe |
get-design-system-kit |
That system's tokens and component code, ready to install |
get-ui-principle |
Guidance on hierarchy, spacing, typography, depth, motion and more |
get-ux-principle |
Guidance on flows, forms, navigation, errors and onboarding |
find-icons |
Icons from one library, so the style stays consistent |
get-review-rules |
Accessibility and visual-design checks to fix its own work |
To check UI code yourself, run npx better-design review in your project.
Try it
Ask your agent:
Use Better Design to build a settings page with my project's design system, then review it for accessibility and consistency.
Install a design system with shadcn
Every design system is also a shadcn registry. Browse them at better-design.com/design-systems, then install one component:
npx shadcn@latest add https://better-design.com/registry/<design-system>/<component>.json
For example, the Cashmere button:
npx shadcn@latest add https://better-design.com/registry/cashmere/button.json
Or the full Cashmere theme and components:
npx shadcn@latest add https://better-design.com/registry/cashmere/all.json
This repository
This repository holds the agent skill in skills/better-design, and component and registry sources in components/ and registry/.
The transition components come from one source, scripts/transitions-src/. After you edit it, run node scripts/generate-transitions.mjs, then run the tests:
cd tests && bun install && bun run test
License
MIT
