agentleFS
OneWave-AIOneWave-AI/claude-skills/claude-design-critic/SKILL.md

claude-design-critic

Skill378 starsChanged 52 days agoMITView on GitHub

Audit a website or UI and de-AI it — find the patterns that make it look template-generated (in both design and copy) and return specific, prioritized fixes that push it toward editorial, premium, human-crafted. Reviews layout, color, type, spacing, motion, accessibility, AND the words. Use after building or generating any frontend, or when a site looks "fine but generic" and you can't say why.

The file

We split this skill into the rules it gives an agent

3 rules. About 0 are common, 2 are distinctive, and 1 is very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈2

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Use it as the finishing pass on claude-landing-composer output, on any vibe-coded frontend, or on a live site that feels generic.

    line 12
  2. Distinctive:

    Every section a centered stack?

    line 23
  3. Distinctive:

    Default system sans at 2–3 sizes.

    line 29

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Claude Design Critic

Some sites are technically fine and still scream "an AI made this in one shot." This skill names exactly why and tells you what to change. It reviews the design and the copy, because generated-looking text gives a build away as fast as a centered hero and a purple gradient.

Use it as the finishing pass on claude-landing-composer output, on any vibe-coded frontend, or on a live site that feels generic. It pairs with the design tokens from claude-design-system-architect (audit against them when they exist).

Step 1 — Take in the target

A URL (WebFetch + screenshot), a local project (read the components/styles), or pasted code. Establish: what is this page for, who's the audience, and what's the one action it wants? A critique without the goal is just opinion.

Step 2 — Audit across dimensions

Go dimension by dimension and flag concrete instances, not vibes:

Layout & composition

  • Every section a centered stack? Three-identical-cards reflex? Predictable hero → cards → CTA with no rhythm? Symmetry where asymmetry would feel crafted? Cramped or uniform whitespace?

Color

  • Purple or default-AI gradients (the dead giveaway). Too many competing accents. Off-brand or arbitrary hexes not mapped to tokens. Contrast failures (check AA).

Type

  • Default system sans at 2–3 sizes. No real modular scale. Weak hierarchy. Generic pairing. Line length / line-height that reads like a default.

Spacing & detail

  • Uniform padding everywhere. No optical adjustments. Borders/shadows that are all identical or all heavy.

Motion

  • The same fade-up on every element. Motion that decorates instead of directs. prefers-reduced-motion ignored.

Iconography & assets

  • Emoji used as UI (replace with Lucide/Heroicons). Generic stock imagery. Placeholder logos left in.

Copy (review this as hard as the design)

  • AI tells: "elevate", "unlock", "seamless", "empower", "in today's fast-paced world", "we're thrilled to", "the power of", relentless em-dashes, every sentence a tricolon.
  • Generic value props ("the best way to X"), hedged language, "Learn More" buttons, "Welcome to {Product}" heroes, filler microcopy.
  • Flag the exact lines and rewrite the worst offenders.

Accessibility & semantics

  • Heading order, alt text, focus states, semantic landmarks, tap-target sizes.

Step 3 — Report with prioritized, specific fixes

# Design Critique — {target}
Generated: {timestamp} · Goal: {…} · Verdict: {SHIP / FIX FIRST / REBUILD SECTION}

## The 30-second read
The 2–3 things making this look generated, in plain language.

## Findings (prioritized: High → Low)
| # | Dimension | What | Where (selector/line/section) | Why it reads as AI | Fix |

## Copy rewrites
"{exact current line}" → "{rewritten line}"

## Quick wins (under 30 min, high impact)
## Bigger moves (worth the time)
## What's already good (keep it)

Be specific enough that someone could apply every fix without asking a question. Point to the file/section/line. Where tokens exist, cite the token that should have been used.

Step 4 — Offer to apply

Offer to implement the high-priority fixes directly (edit the components/copy) and re-audit, or hand a rebuild to claude-landing-composer.

House standard

Premium = intentional layout rhythm, restrained palette, real type scale, generous whitespace, motion with purpose, human copy. Generated = centered everything, rainbow/purple gradients, default sans, uniform padding, fade-up-on-all, and "elevate your workflow." Push every target from the second toward the first. Never purple, never emoji-as-UI.

Guardrails recap

Critique design AND copy · every finding is specific and located · cite tokens where they exist · prioritize by impact · offer to apply, then re-audit.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.