Deslop

---

Generated pages share a look: an uppercase eyebrow over every heading, 01 / 02 / 03 section numbers, mono labels, pill buttons, a soft gradient, a period at the end of every headline. Each choice is harmless alone. Together they read as "nobody designed this".

AI De-slop gives Claude a precise playbook for removing them:

• Exact rules for 20 visual tells and 11 copy tells, with the action to take and the cases where the element should stay.
• An honesty gate that blocks invented proof: unsourced numbers, made-up reviews and logos, fake urgency, dead links and leftover placeholders.
• An audit script that scans CSS, HTML, JSX/TSX, Vue, Svelte, Astro and data files, lists every hit with file and line, and fails until fix-level tells reach zero. It reads styles and markup for the visual tells, and the visible text for the copy tells and honesty claims.
• A repair checklist for what removal breaks: grid columns that held a number, indents that aligned past one, dead classes, fonts that change line counts.
• A definition of done and a fixed report format, so a pass is never declared finished on a subset.

It was built while de-slopping 27 production concept websites and the site that hosts them, and every rule in it comes from something that went wrong or right during that work.

Install

Claude Code, as a plugin

/plugin marketplace add elmir-mammadli/ai-deslop
/plugin install ai-deslop@ai-deslop

Claude Code, as a personal skill

git clone https://github.com/elmir-mammadli/ai-deslop.git /tmp/ai-deslop
cp -R /tmp/ai-deslop/skills/ai-deslop ~/.claude/skills/

Every project on your machine can now use it. To share it with a team instead, copy skills/ai-deslop into the project's .claude/skills/ folder and commit it.

Claude.ai

1. Download ai-deslop.zip from the latest release, or zip the skills/ai-deslop folder yourself.
2. Open Settings → Capabilities → Skills and upload the zip.

Skills on claude.ai depend on your plan and settings; if you do not see the Skills section, it is not enabled for your account yet.

Use

Ask in plain words. The skill loads on its own when the request matches:

Deslop the marketing site in apps/web.
This landing page looks AI-made. Fix it.
Here are the 20 AI slop indicators. Go through every page and remove them.
Build a pricing page for a roofing company, art-directed, no AI tells.

Claude then works through a fixed order: scope, audit, keep list, edit, repair, verify, report. It stops only when the definition of done is met, and ends with a report of what was removed, what was kept on purpose and why, what broke and was repaired, and what was checked.

The audit script

The script ships inside the skill and runs on its own too. It needs Python 3 and nothing else.

python3 skills/ai-deslop/scripts/audit.py src
python3 skills/ai-deslop/scripts/audit.py src --keep-caps ".wordmark,.logo,.heroTitle"
python3 skills/ai-deslop/scripts/audit.py src --only caps,tracking,period
python3 skills/ai-deslop/scripts/audit.py src --json > audit.json

Option	What it does
--keep-caps	Selectors allowed to keep uppercase and positive letter-spacing: wordmarks, real signage, condensed display headlines
--only	Report only these tells, comma separated
--json	Machine-readable output

Hits are grouped into fix tells, which must reach zero, and check tells, which need a human verdict but never fail the run. Check tells are gradients, glows, CSS counters, eyebrows, accent stripes, emphasis in headings, shaped corners, "not just X" contrasts, Title Case, emoji, exclamation marks, em dashes, scattered bold, and the honesty claims (stat, proof, fake-live), which pass only with a real source. The exit code is 0 when no fix-level tells remain and 1 otherwise, so the script works as a CI gate.

Sample run on the files in examples/:

python3 skills/ai-deslop/scripts/audit.py examples/before.html

== caps [fix]: ALL CAPS text-transform or utility (18)  [3]
  examples/before.html:24  text-transform: uppercase; letter-spacing: 0.18em; color: #7c3aed;
...
Summary
  total            65  (fix: 41, check: 24)

FAIL: fix-level tells remain

python3 skills/ai-deslop/scripts/audit.py examples/after.html
...
PASS: no fix-level tells left

Keeping something on purpose

Some tells are the right call: rounded pipe ends on a plumbing site, a print texture that is the whole art direction. Mark the line, or the line above it, and the audit skips it:

border-radius: 999px; /* deslop-keep: rounded pipe ends */

{/* deslop-keep: printed paper edge is the art direction */}
<feTurbulence type="fractalNoise" baseFrequency="0.9" />

To skip a whole block, such as a table that quotes the tells as examples, wrap it:

<!-- deslop-keep-start: this table quotes the tells as examples -->
...
<!-- deslop-keep-end -->

Always give a reason. The marker is a decision, not an escape hatch.

This is the beginning of the README. Read the rest at the original. Read the full README ↗