Audit
Score an existing React + Tailwind site against the anti-slop checklist and produce DESIGN-AUDIT.md with evidence. Use when the user says their site "looks AI-generated", "looks generic", "feels off", asks "why is my site ugly", or wants a design audit/score before improving it. Read-only — never edits source.From its SKILL.md
npx -y skills add aahil62/unslop --skill auditAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 16 stars16 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
SKILL.md
2.9 KB, as published. Nobody here has run it
Design Audit
Audit the current project's visual design and produce a scored, evidence-backed
DESIGN-AUDIT.md. This skill is strictly read-only on source code — it writes
only the audit report and screenshots.
Preconditions
- Confirm the project is React + Tailwind (look for
tailwind.config.*or the Tailwind v4 CSS import, plus React in package.json). If it isn't, stop and say: v1 of unslop supports React + Tailwind only. - The site must be viewable. Find the dev command (
npm run devor equivalent) and the port. Start it in the background if not already running.
Procedure
-
Capture. Run the bundled screenshot script against the running site:
node "${CLAUDE_PLUGIN_ROOT}/scripts/screenshot.mjs" <url> ./unslop/screenshotsIt captures 375 / 768 / 1024 / 1440 px full-page shots and reports horizontal overflow per viewport. If Playwright is missing, it prints install instructions — follow them, then re-run.
-
Deterministic checks.
node "${CLAUDE_PLUGIN_ROOT}/scripts/slop-scan.mjs" . node "${CLAUDE_PLUGIN_ROOT}/scripts/contrast-check.mjs" <url>slop-scangreps the source for slop tells (stock palette, transition-all, arbitrary px values, uniform radius, weight sprawl) with file:line evidence.contrast-checkreports WCAG AA failures on the rendered page. -
Visual evaluation. Read all four screenshots. Walk
${CLAUDE_PLUGIN_ROOT}/rules/anti-slop-checklist.mditem by item — every item is PASS / FAIL / N-A with evidence (file:line from the scans, or a screenshot observation named precisely, e.g. "1440px: hero is centered headline + two buttons + 3-col icon grid → L1 FAIL"). Read key source files to confirm suspected failures; do not guess. -
Report. Write
unslop/DESIGN-AUDIT.md:- Overall score (passes ÷ applicable × 100) and per-category scores.
- Failures with evidence, grouped by category, referencing checklist IDs.
- Top 5 fixes by visual impact, ordered, each mapped to checklist IDs.
- Paths to the screenshots.
-
Tell the user their score, the 2–3 most damning findings in plain language, and the next step: run
/unslop:interviewto define a design lane, then/unslop:rethemeto fix it.
Rules
- Never modify source files, configs, or styles. Audit only.
- Every failure needs evidence a stranger could verify. "Feels generic" is banned.
- If the dev server can't start, report the build error and stop — that's a prerequisite bug, not a design finding.