antislop

Anti Slop: Rules for AI Coding Agents. It stops them from generating generic "AI slop" UI and copy, without letting the result turn sterile. It is a filter, not a style guide: no prescribed colors, fonts, or layouts. It is not only for building pages: it also writes and audits copy, so AI text stops reading like AI. And it never beautifies on its own; DESIGN.md (yours) is where beauty and direction come from.

New here? Start with the guide. It explains what antislop is and how to install it, from zero.

• 38 mandatory rules (R-01 to R-38) in three tiers: Hard Gate (absolute), Purpose-Gate (technique allowed, reason required), Quality Locks (consistency)
• A Liveliness Toolkit with three dials (ENERGY / RHYTHM / MOTION) and a Design Read, so the result is alive and specific, not just "clean"
• A Delivery Gate: a mandatory PASS/FAIL report in four blocks, run before anything ships
• Additive skills, one per concern, so an agent only loads what a task needs

The core prevents slop but cannot invent direction. DESIGN.md (yours) supplies it; a sterile result means the direction was missing, not that the filter failed (R-37).

antislop is a set of standard agent skills (one folder per skill, SKILL.md) you can install as a package. The core is always loaded; the skills load only for the task at hand. Pick one of these four paths.

1. The picker (recommended). One command, then choose. It shows the antislop banner, lists the skills with the core locked on, asks where (project or global) and which agents (Claude Code, Antigravity, Codex, OpenCode, Cursor, Gemini CLI, Hermes), then installs the folders and writes the pointer that loads antislop every session. The skills directory (path 2) does not write that pointer, so this is the one to use:

npx antislop-ai

2. The skills directory. antislop is listed on skills.sh, the open directory for agent skills:

npx skills add miqdadbadjuber/anti-slop

Add --all for every skill, -g for a global install, or --skill <name> for a single one. Run --list first to see what is available.

npx skills add copies the skill folders but does not write the agent entry pointer that loads antislop every session; skills.sh does not write them, so that gap is theirs, not antislop's. That is why the picker (path 1) is the recommended way to install. If you already used path 2, run npx antislop-ai, choose the same skills and agent, and pick Keep what is there when it finds the existing folders; that writes the pointer.

skills.sh reads the skill folders straight from this repository, so the listing appears as soon as the repo is live; there is no separate setup step.

3. The plugin (Claude Code). Add the marketplace once, then install the plugin:

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

4. The plugin (Antigravity). The same repo is a full Antigravity plugin: a root plugin.json, the six skills registered as Antigravity skills, and a rules/antislop.md pointer that loads antislop into every session. Install it with the Antigravity CLI:

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

Every skill is a folder of the open Agent Skills standard (<name>/SKILL.md), so it drops into any agent that reads the standard: Claude Code (.claude/skills/), Codex (.codex/skills/), Antigravity (.agents/skills/), OpenCode (.opencode/skills/), Cursor (.cursor/skills/), Gemini CLI (.gemini/skills/), and Hermes (~/.hermes/skills/). The picker (path 1) asks which of these agents you use and installs into them, creating the skill folder if it does not exist yet; the skills directory (path 2) handles the same agents and more. The plugins are per-agent doors: path 3 is the Claude Code marketplace plugin, path 4 the Antigravity plugin.

Manual (single file, no packaging). The core antislop.md alone remains a complete filter you can paste into any chat window. Download it and tell your agent to read it; the First-Run wizard inside it installs skills the manual way:

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

Pick what matches the work: UI work → antislop-ui, copy work → antislop-copywriting, people work → antislop-human, mobile layout work → antislop-layoutmobile, code comments work → antislop-code, more than one → install several, or none (the core alone is a complete filter).

antislop is used one of two ways, chosen at the start of a session:

• During guides the work while it is built, ending with the Delivery Gate. Use it when building new UI.
• After audits finished work: a numbered findings list, you approve which to fix, then a follow-up report. Use it to clean up existing output.

v3.1.0 shipped the antislop-code skill, per-skill READMEs, and the tagline rename. v3.1.1 was a patch: the picker stopped copying per-skill READMEs into projects, and the wizard dropped install commands. v3.1.2 removes the per-skill READMEs entirely and makes the picker ask which agent to install into, so a fresh Antigravity or Codex project lands in the right folder. v3.1.3 states the DESIGN.md boundary explicitly, adds a security explainer (SECURITY.md), and documents what npx skills add does and does not install. v3.2.0 adds OpenCode, Cursor, Gemini CLI, and Hermes to the picker, so one run covers seven agents and the shared .agents/skills/ folder covers the long tail that reads the standard. v3.2.1 closes UI slop gaps: new patterns for bento grids, Lucide-style icon sets, colored left stripes, fake terminal windows, and demos without a product, plus rule extensions for the palette family (harsh gradients, purple-and-black, neon, pastel, radial orbs), dot grids, the typeface roster (Geist Mono and friends), and pricing always shown as three columns. v3.2.2 ships the plugin as an Antigravity door: agy plugin install https://github.com/miqdadbadjuber/anti-slop registers the six skills and loads the antislop pointer into every session through the plugin's rules/ component. See ROADMAP.md for the tracker, including the cross-agent plugin plan.

Is antislop a style guide? No, a filter. It does not prescribe colors, fonts, or layouts. It rejects technique without purpose and requires liveliness; direction is yours.

Which agents does it work with? All of them, but the install paths differ:

• The picker and the skills directory support Claude Code, Codex, Antigravity, OpenCode, Cursor, Gemini CLI, and Hermes (the picker detects each agent's skill folder; Hermes installs globally only). These are the recommended paths.
• The plugins are per-agent doors: the Claude Code marketplace plugin (path 3) and the Antigravity plugin (path 4), both installed from the same repo.
• The single file (antislop.md) works with any agent that reads plain Markdown, including a plain chat window.

The packaged skills use the open Agent Skills standard (folder per skill), so they drop into any tool that reads the standard.

What is a "skill"? A folder that goes deeper into one concern (UI, copywriting, accessibility, and so on), holding a SKILL.md with its rules. It references the core rules by number and never duplicates them, so adding a skill does not change the core.

What are DURING and AFTER? The two usage modes: DURING applies the rules while building, AFTER audits finished work. You pick one at the start of a session.

Found a new AI slop pattern, a rule that missed something, or a bug in the installer? Open an issue. PRs are welcome for new AI slop patterns, clarifications, or checklist items out of sync with their rule.

MIT: LICENSE