anti-slop

Anti Slop: Rules for AI Coding Agents

A rulebook that stops an AI coding agent shipping generic UI, filler copy, and AI-shaped code. A filter, not a style guide: no prescribed colors, fonts, or layouts, and direction stays yours.

New here? GUIDE.md is the from-zero walkthrough.

See the difference

The same brief, built four ways. antislop filters and DESIGN.md supplies direction. They are different jobs, and these are the four results.

UI

Nothing at all	antislop alone	DESIGN.md alone
Where most AI output starts: a sparkle logo, a beta pill, and a fake terminal.	Honest, because the filter removed the invented numbers. Plain, because beauty is not its job.	The direction lands, but the slop stays, because DESIGN.md directs and does not filter.

The fourth is the only one of the four that is clean and directed at the same time:

antislop + DESIGN.md
Honest numbers and a real direction in the same build. The filter removes what should not be there; DESIGN.md fills the space that leaves, which is the one thing neither manages alone.

Copy

One prompt, run twice.

Before	After

Code

One file, run twice.

Before	After

Every image here opens full size if you click it.

Install

antislop ships as standard agent skills: one folder per skill, holding a SKILL.md. Installation differs per agent, so pick the section for the one you use. Each route is walked through from zero, with update and removal, in GUIDE.md.

The installer (recommended)

One command, then answer the prompts. It asks which skills you want, where to install them (this project or everywhere), and which agents you use, then copies the folders and writes the pointer that reloads antislop every session.

npx antislop-ai

The skills directory

antislop is listed on skills.sh, the open directory for agent skills. This copies the same folders as the installer and nothing else, so antislop reloads by description alone.

npx skills add miqdadbadjuber/anti-slop

Claude Code - Plugin

/plugin marketplace add https://github.com/miqdadbadjuber/anti-slop
/plugin install antislop@anti-slop

Antigravity - Plugin

agy plugin install https://github.com/miqdadbadjuber/anti-slop

Codex - Plugin

codex plugin marketplace add miqdadbadjuber/anti-slop
codex plugin add antislop@anti-slop

Cursor - Plugin

agent plugin marketplace add https://github.com/miqdadbadjuber/anti-slop

Then open Customize, find antislop, and select Install.

Kimi Code - Plugin

/plugins install https://github.com/miqdadbadjuber/anti-slop

Cline - Plugin

cline plugin install https://github.com/miqdadbadjuber/anti-slop.git

This door covers the Cline CLI. For the VS Code or JetBrains extension, use the installer.

Oh My Pi - Plugin

omp plugin marketplace add miqdadbadjuber/anti-slop
omp plugin install antislop@anti-slop

Pi - Package

pi install git:github.com/miqdadbadjuber/anti-slop

The single file

antislop.md on its own is a complete filter you can paste into any chat window, with no packaging and no folders.

curl -o antislop.md https://raw.githubusercontent.com/miqdadbadjuber/anti-slop/main/antislop.md

What it does

• 38 mandatory rules (R-01 to R-38) in three tiers: Hard Gate, Purpose-Gate, and Quality Locks.
• A Liveliness Toolkit: three dials (ENERGY / RHYTHM / MOTION) and a Design Read, so the result comes out alive rather than merely clean.
• A Delivery Gate: a mandatory PASS/FAIL report in four blocks, run before anything ships.
• Six skills, one per concern, so an agent loads only what a task needs.

The core prevents slop but cannot invent direction. DESIGN.md (yours) supplies it, and a sterile result means the direction was missing, not that the filter failed (R-37). antislop never beautifies on its own.

Skills

Skill	Covers	Pick it for
antislop	The core filter: rules, tiers, the Delivery Gate, liveliness	Everything. Always loaded
antislop-ui	Layout, color, components, decoration, motion, structure	UI and visual work
antislop-copywriting	Headlines, CTAs, tone, fake stats, anti-AI writing, markdown hygiene	Copy and text
antislop-human	Contrast, keyboard, focus, states	Accessibility
antislop-layoutmobile	Reflow across screen widths, breakpoints, grids, overflow, tap targets	Responsive work
antislop-code	AI-slop comments: which to remove, which to keep	Comment cleanup

Install one, several, or the core alone.

Usage modes

antislop runs one of two ways, and by default the agent asks which at the start of every session. Both end with a report you can check; they differ in when the rules apply.

• During guides the work while it is built, and the session closes with the Delivery Gate report. Use it when you are building something new.
• After audits work that already exists: a numbered findings list, you approve which to fix, then a follow-up report. Use it to clean up output you already have.

Saving a preference is opt-in. With no settings file, antislop keeps asking in every new session exactly as it does today. Save your preferred mode once to skip that question:

npx antislop-ai --mode during

Use after instead for audits, ask to restore the question in every session, or --mode alone to view the setting. The file is shared, so one command covers every agent and every project: ~/.config/antislop/settings.json on Linux and macOS, %APPDATA%\antislop\settings.json on Windows.

A mode you ask for in the current chat always wins for that session and never chan