better-design
🎨 Open-source design MCP server + shadcn/ui registry — AI design systems for Claude Code, Cursor, Codex, GitHub Copilot & any MCP client. 31 brand-grade themes (Linear, Stripe, Vercel, Notion, Apple, Supabase, Figma…) + design tokens, UI principles & WCAG rules. Install any component with one command.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/marvkr--better-design)HTML
<a href="/listings/marvkr--better-design"><img src="/api/listings/marvkr--better-design/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
Install the Better Design agent skill, then connect its MCP tools:
npx skills add marvkr/better-design --skill better-design npx better-design
Run each command once, then restart your coding agent. The skill tells supported agents when to use Better Design. The installer detects your coding tools and connects the MCP without replacing their existing configuration. No account is required.
Connect via Remote MCP manually
Connect any MCP-compatible client to the hosted endpoint — no local setup needed.
1. Go to [better-design.com/settings](https://better-design.com/settings) to get an API key. 2. Add the remote MCP to your client config:
{
"mcpServers": {
"better-design": {
"url": "https://better-design.com/api/mcp",
"headers": { "Authorization": "Bearer YOUR_API_KEY" }
}
}
}Connect via Claude Desktop (remote MCP)
Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
{
"mcpServers": {
"better-design": {
"url": "https://better-design.com/api/mcp",
"headers": { "Authorization": "Bearer YOUR_API_KEY" }
}
}
}Restart Claude Desktop. You can now ask Claude to use Better Design while building UI.
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 75 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- # Better Design
- 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](https://better-design.com) · [Docs](https://better-design.com/docs) · [Design systems](https://better-design.com/design-systems) · [Installation guide](https://better-design.com/mcp/install)
- ## Install
- Run these commands in your project:
- ```bash
- 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](https://better-design.com/design-systems), then install one component:
- ```bash
- npx shadcn@latest add https://better-design.com/registry/<design-system>/<component>.json
- ```
- For example, the Cashmere button:
- ```bash
- npx shadcn@latest add https://better-design.com/registry/cashmere/button.json
- ```
- Or the full Cashmere theme and components:
- ```bash
- 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:
- ```bash
- cd tests && bun install && bun run test
- ```
- ## License
- MIT
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.