design-system

Use it when:: You're starting a design system, checking visual consistency before a redesign, or reviewing a PR that touches styling.
It does:: In one of three modes: pulls tokens from your CSS, Tailwind or styled-components, scores the UI, or checks it for AI-slop patterns.
You get:: DESIGN.md, design-tokens.json and a self-contained design-preview.html, or a 0-10 score per dimension with fixes at exact file and line.
Needs:: A browser MCP, which the generate mode uses to study three competitor sites.
AI slop means:: Gradients on everything, purple-to-blue defaults, purposeless glass cards, excessive scroll animation and generic centered heroes.

TL;DR

ECC's design-system skill has three modes. Generate scans your CSS, Tailwind or styled-components code for colors, typography, spacing, border radius, shadows and breakpoints, looks at three competitor sites through a browser MCP for inspiration, and proposes a token set as JSON and CSS custom properties, with a DESIGN.md explaining each decision and an HTML preview page with no dependencies. Audit scores the UI from 0 to 10 on color consistency, typography hierarchy, spacing rhythm, component consistency, responsive behavior, dark mode, animation, accessibility, information density and polish, with examples and a fix at a file and line for each. Slop check flags generic AI-generated design: gradients on everything, purple-to-blue defaults, glass cards with no purpose, rounding where it doesn't belong, excessive scroll animation, centered hero text over a stock gradient and fonts with no personality. Its examples show the modes called as commands, such as an audit of pages on localhost.

Summarizes the skill at d2ef268.

npx skills add https://github.com/affaan-m/ecc --skill design-system

skills.sh page Source on GitHub All skills from affaan-m/ecc

Total Downloads: 6,000 on skills.sh, Nov 9, 2026
Repo stars: 299,776 affaan-m/ecc
First seen: May 19, 2026 on skills.sh

Weekly Downloads

474

+71% over the 8 weeks to Nov 9

Weekly values

Week to	Installs
Sep 21	277
Sep 28	174
Oct 5	170
Oct 12	259
Oct 19	440
Oct 26	435
Nov 2	494
Nov 9	474

Category	category:design category:software-engineering Taste for interfaces that don't look generated: direction, motion and accessibility. Everything for building software: planning, coding, debugging, design, frameworks, cloud, agents and skills.
Type	type:workflow A multi-step process the agent follows: interview, debug, run a TDD loop, review.
Effect	effect:local Its own steps create or change files, git state or local tools.
Needs	needs:mcp needs:browser Needs an MCP server connected. Drives a real Chromium or Chrome browser.
Publisher	by:community Everyone else. Unverified vendor claims default to community.
Topics	design-system anti-slop design

SKILL.md

From affaan-m/ecc at d2ef268. Checked daily, last changed Nov 6, 2026.

Frontmatter

name: design-system
description: "Generate a design system from an existing codebase or audit one for visual consistency: extract tokens (colors, typography, spacing, shadows) into design-tokens.json and CSS custom properties with DESIGN.md rationale and an interactive HTML preview, score the UI across 10 dimensions, and flag AI-slop patterns. Use when starting a design system, auditing visual consistency before a redesign, or reviewing a PR that touches styling."
metadata:
  origin: ECC

Design System — Generate & Audit Visual Systems

When to Use

Starting a new project that needs a design system
Auditing an existing codebase for visual consistency
Before a redesign — understand what you have
When the UI looks "off" but you can't pinpoint why
Reviewing PRs that touch styling

How It Works

Mode 1: Generate Design System

Analyzes your codebase and generates a cohesive design system:

1. Scan CSS/Tailwind/styled-components for existing patterns
2. Extract: colors, typography, spacing, border-radius, shadows, breakpoints
3. Research 3 competitor sites for inspiration (via browser MCP)
4. Propose a design token set (JSON + CSS custom properties)
5. Generate DESIGN.md with rationale for each decision
6. Create an interactive HTML preview page (self-contained, no deps)

Output: DESIGN.md + design-tokens.json + design-preview.html

Mode 2: Visual Audit

Scores your UI across 10 dimensions (0-10 each):

1. Color consistency — are you using your palette or random hex values?
2. Typography hierarchy — clear h1 > h2 > h3 > body > caption?
3. Spacing rhythm — consistent scale (4px/8px/16px) or arbitrary?
4. Component consistency — do similar elements look similar?
5. Responsive behavior — fluid or broken at breakpoints?
6. Dark mode — complete or half-done?
7. Animation — purposeful or gratuitous?
8. Accessibility — contrast ratios, focus states, touch targets
9. Information density — cluttered or clean?
10. Polish — hover states, transitions, loading states, empty states

Each dimension gets a score, specific examples, and a fix with exact file:line.

Mode 3: AI Slop Detection

Identifies generic AI-generated design patterns:

- Gratuitous gradients on everything
- Purple-to-blue defaults
- "Glass morphism" cards with no purpose
- Rounded corners on things that shouldn't be rounded
- Excessive animations on scroll
- Generic hero with centered text over stock gradient
- Sans-serif font stack with no personality

Examples

Generate for a SaaS app:

/design-system generate --style minimal --palette earth-tones

Audit existing UI:

/design-system audit --url http://localhost:3000 --pages / /pricing /docs

Check for AI slop:

/design-system slop-check