Skip to content

yetone/kill-ai-slop

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

40 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Kill AI Slop

killaislop.com

Vibe-coded products are ugly in the same specific way: indigo gradients, glowing cards, emoji everywhere, a mascot in every corner, ALL-CAPS stat-cards. It's what a machine reaches for when it has no taste but wants to look impressive, and it's so common you've stopped seeing it.

Kill AI Slop is two things:

  1. A website, a multilingual field guide (English, Chinese, Japanese, and Korean) that catalogues 33 AI-slop tells, each with an interactive before→after demo showing the clean fix. The site is itself built as a rebuttal to everything it catalogues.
  2. An Agent Skill, kill-ai-slop, which turns that catalogue into action: it scans a web project for the code-level signals of each tell, explains why each reads as machine-made, and proposes (or applies) the clean fix.

Every tell is one you can find in real, shipped products, not a strawman. Each entry rebuilds the tell in plain HTML so you can see the machine-default and the clean fix side by side.

Repo layout

website/   Astro site, the field guide (multilingual, static, zero-JS-by-default)
skill/     the kill-ai-slop Agent Skill (SKILL.md + references + scanner)

The website

Live at killaislop.com. To run it locally:

cd website
npm install
npm run dev        # http://localhost:4321
npm run build      # → dist/  (static, deploy anywhere)

Design system: paper + ink, one editorial red used like a proofreader's pen, hierarchy from scale and space, hairline rules, no gradients / emoji / glass / badges. See website/src/styles/tokens.css for the rules it holds itself to, and website/src/data/catalogue.ts for the taxonomy (the single source of truth shared with the skill).

The skill

Universal agent installer

Run the following command and follow the prompt to install it to your favorite coding agents:

npx skills add yetone/kill-ai-slop

Manual installation

Install it without touching a single file: paste this to your coding agent (Claude Code, Cursor, etc.) and it fetches the skill and drops it into its own skills directory for you.

Install the kill-ai-slop skill from
https://github.com/yetone/kill-ai-slop/tree/main/skill

Copy everything in that directory into a kill-ai-slop/ folder
inside your agent's skills directory, then confirm it's registered.

Then just tell it to "kill the AI slop in this project". Prefer to install by hand? See skill/README.md.

You can also run the scanner directly. Point it at any web project:

node skill/scripts/scan.mjs path/to/project          # grouped report
node skill/scripts/scan.mjs path/to/project --json    # machine-readable

--only= / --skip= filter by tell id, --exclude= drops paths, --rules=extra.mjs loads your own language- or stack-specific tells, and deslop-ignore comment directives suppress hits you've confirmed as intentional — see skill/README.md.

License

Apache-2.0.

The scanner is dependency-free and never edits files. In an Agent-Skills host (e.g. Claude Code), invoke the skill and it will scan, triage, report, then fix, following skill/SKILL.md. See skill/references/ for the taxonomy, detection patterns, and remediation playbook, and skill/README.md for install steps.

Every example is a rebuild

The demos are reconstructed in plain HTML, for commentary, criticism, and education. The point is not to dunk on any one project. It's to make the ugly defaults visible again, so you can choose against them.

About

A field guide to the visual & copy tics of AI-generated products — and an Agent Skill that scans your project and strips them out. https://killaislop.com

Resources

License

Stars

702 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors