designlint-skill

# DesignLint

**Force distinctive, human-feeling UI/UX design before any AI agent writes code. Audit and improve existing interfaces.**

By [Ruben Granet](https://github.com/rgranet) · v1.2.0 · MIT License

---

## The Problem

AI coding agents converge. Left unconstrained, they always produce the same thing:

**UI:** Inter font · Purple/blue gradients · White background · `rounded-xl` cards · Opacity fade-ins

**UX:** Tab bar (5 icons) · List → Push detail · Modal for everything · Green toast on success · 3-screen onboarding carousel

**Voice:** "Submit" · "An error occurred" · "No items found" · "Success!" · (spinner)

This isn't a style preference — it's a structural failure. Every AI-generated interface looks, feels, and sounds like every other AI-generated interface.

**DesignLint** breaks that convergence with two modes:
- **Create** — Understand the user, make 9 deliberate design decisions, resolve a creative tension, and critique the result before shipping.
- **Audit** — Diagnose an existing interface against the same standards, score it, and produce a concrete improvement plan.

---

## Two Modes

### Create Mode
*"Build me a task management app"*

The agent stops before writing code. It identifies the user and their emotional state, picks a creative tension, selects an archetype as a departure point (not a template), makes 9 design decisions covering aesthetics through voice, and runs a human critique before shipping.

### Audit Mode
*"What's wrong with this UI?" / "Improve this interface" / "Review this design"*

The agent documents what exists, runs the full convergence scan (UI, UX, and human), scores the design 1–5, produces an improvement brief with the top 3 highest-impact changes, and optionally executes the improvements.

---

## Before / After

Without this skill, an AI agent asked to "build a task management app" produces:

```
UI:  Inter · #7C3AED primary · white bg · rounded-xl cards · fade-in
UX:  Tab bar (Home, Tasks, Calendar, Search, Profil