ai-design-check

ai-design-check is an open-source package from Enmera that finds what makes an AI-built interface look generated, helps fix it, and keeps it from coming back. It combines 141 design rules, a checker that needs no dependencies and no API key, and agent skills for Claude Code, Cursor and Codex. It reads web projects (React, Vue, Svelte, Laravel Blade, HTML with Tailwind, Bootstrap or plain CSS) and SwiftUI, Jetpack Compose, Flutter and React Native apps.

What It Is

A design linter for AI-assisted front-end work. Running the checker over a project reports each problem with its file, line and rule, covering areas such as accessibility, type and shape, copy, components, layout, visual language, motion, data and localisation. Rules are documented in English and Turkish. Mechanical fixes (spacing and corners moving to the nearest step of the scale, very heavy type becoming bold) can be applied with a flag and no agent, while decisions about colours, emoji, words and hierarchy stay in the report.

Workflow and Commands

The flow is check, fix, then hand the rest to an agent. Installing the skills lets an agent measure a screen, write a short brief, repair it and report findings before and after. Other commands include:

• scan: inspects the running page in Chrome at desktop and phone width for contrast, sizes, overlaps and script errors.
• redesign: has an agent study a page and rework it pass by pass on a git branch, discarding passes that lose content or add errors.
• inventory: counts distinct looks of buttons, inputs, headings and cards.
• narrow: checks phone widths and long languages.
• system: generates fonts, a type scale, colours and tokens from a brand colour and character.
• story: produces a before/after video.

Fitting It Into a Project

The checker runs on Node 20+ and can be added to CI, where it exits 1 on errors. A hook for Claude Code or any agent that passes a file path can check each edited file. A baseline file records existing findings so only new ones are reported, and a JSON config tunes rules, spacing scale, shared components and allowances. Claude Code and Codex plugin installs are also documented.