AgentIndex icon
AgentIndex
ToolsMCP ServersHOTCategoriesTrendingNewBest ListsCompareGuides
Submit Tool
ToolsMCP ServersHOTCategoriesTrendingNewBest ListsCompare
Home/
Dev Tooling/
roast-my-design-system
roast-my-design-system logo

roast-my-design-system

Active·★ 27·MIT·Updated 2026-10-16

This free CLI tool and Claude Code skill analyzes your repository's design system using real data, providing a health score, detailed reports, and actionable fixes. It also generates rules to ensure AI agents like Claude, Cursor, and Copilot adhere to your established design guidelines, preventing UI inconsistencies.

#CLI Tool#Design System#AI Agent#Code Analysis#Frontend Development#Developer Tools
© 2026 AgentIndex.app|Built by a 10-year iOS Developer.
Best by use caseAboutContactAdvertisePrivacy PolicyTerms of UseQYSGitHubBuy me a coffee ☕

Browse by Category

MCP ServersCode AssistantWorkflow AutomationRAG / Knowledge BaseMulti-AgentBrowser AutomationLLM InfraDev ToolingObservability

Not affiliated with Anthropic, OpenAI or Microsoft.

Guides
#SARIF
$ Install
$ npx roast-my-design-system
↗ Visit site★ GitHub
01

Features

01Get a deterministic health score (0-100) for your design system, benchmarked against industry norms.
02Generate comprehensive, self-contained HTML reports detailing every design inconsistency, with real file paths.
03Create `design-system-rules.md` to guide AI agents (Claude, Cursor, Copilot) on canonical components and tokens, preventing design drift.
04Run as a local MCP server, enabling AI agents to get live design system answers and validation during UI development.
02

Compatibility

Node.js
Runtime
Verified via docs
npm
Package Manager
Verified via docs
Claude Code
AI Agent Platform
Verified via docs
Cursor
AI Agent Platform
Verified via docs
GitHub Copilot
AI Agent Platform
Verified via docs
Windsurf
AI Agent Platform
Verified via docs
03

Quick start

1
$ npx roast-my-design-system
04

Use cases

↳Conduct a pre-refactor audit to establish a measured baseline of your design system's health.
↳Diagnose and resolve issues when AI-generated UI appears "almost-but-not-quite right" by identifying duplicated components and stray values.
↳Advocate for design system improvements by sharing self-contained HTML reports with health scores and benchmarks.
↳Utilize the report as a punch list for AI agents to systematically fix design system inconsistencies.
05

Alternatives

⚡Top VS:
VSroslyn-codelens-mcp★66→VSelements★98→VSbasecoat-ui-mcp★38→

Comments

Log in to leave a comment

No comments yet. Be the first!

On this page
01Features02Compatibility03Quick start04Use cases05Alternatives
VS
ns-ui
★34
→
roslyn-codelens-mcp logo
roslyn-codelens-mcp★ 66
Roslyn-based MCP server giving AI agents deep semantic understanding of .NET/C# codebases — 57 tools for navigation, call graphs, diagnostics & code fixes, code-quality auditing, test intelligence, DI graphs, and IL/external-assembly inspection.
VSCompare→
elements logo
elements★ 98
The Design System and UI Agent Harness for AI/ML Factories, Robotics, and Autonomous Vehicles
VSCompare→
basecoat-ui-mcp logo
basecoat-ui-mcp★ 38
Offline MCP server for Basecoat UI (shadcn/ui look, no React): templates, macro layouts, theming/dark-mode contract, static validation.
VSCompare→
ns-ui logo
ns-ui★ 34
223 React components you install as plain source — no runtime package. Tailwind v4 tokens, light and dark. Install with npx shadcn, or connect the MCP server and give an agent the whole catalog.
VSCompare→
Hades logo
Hades★ 29
Unity-aware AI infrastructure for Claude Code — a knowledge graph + 88 MCP tools that let your AI agent know your project, not just grep its files.
VSCompare→
xgrep logo
xgrep★ 20
Ultra-fast indexed code search engine — faster than ripgrep on repeated searches, lighter than zoekt. Built-in MCP server for AI agents. Also does fast file finding (fd/find alternative).
VSCompare→
mcp-app-typescript-template logo
mcp-app-typescript-template★ 21
ChatGPT app template using Pomerium, OpenAI Apps SDK and Model Context Protocol (MCP), with a Node.js server and React widgets.
VSCompare→
maf-doctor logo
maf-doctor★ 14
AI-powered toolkit for Microsoft Agent Framework (MAF) migrations — agents, skills, MCP server, and self-updating guide
VSCompare→
See all alternatives →
gregkozakiewicz /
roast-my-design-system
↗

v5.2.3 · Try it: npx roast-my-design-system · Your AI can write the UI. This makes sure it writes YOUR ui. A health score, receipts, fixes ranked by payoff, rules injected via --apply, a local MCP server via --mcp, and Claude's read of your numbers embedded in the shareable report. Benchmarked against 34 public repos and 10 reputable systems.

27MIT
Last commit1w ago
StatusActive
CategoryDev Tooling
Links
Documentation↗Discussion↗Issues↗Releases↗
Cloud Infrastructure
Ad

Deploy on DigitalOcean

Host your MCP servers, Docker containers, and AI agents with $200 free credit over 60 days.

Claim $200 Free Credit