Files
anti-slop/ROADMAP.md
T

5.0 KiB

antislop: Roadmap

How antislop grows from a single rules file into an installable, cross-agent skill/plugin. New to antislop? Read the guide first. See README.md for the product.

Where we are

The latest release is v3.0.2. antislop is a packaged system: a lean, always-loaded core plus four skills, each shipped as a standard agent skill folder (skills/<name>/SKILL.md):

  • antislop: the core rules filter (rules, tiers, Delivery Gate, liveliness)
  • antislop-ui: UI / visual
  • antislop-copywriting: copy & text
  • antislop-human: human / accessibility, home of the contrast checker
  • antislop-layoutmobile: mobile / responsive

The next release, v3.1.0, ships a fifth skill: antislop-code, the code comment filter.

The system installs three ways from one repo: the interactive picker (npx antislop-ai), the skills directory (npx skills add miqdadbadjuber/anti-slop, listed on skills.sh), and the Claude Code plugin marketplace (.claude-plugin/plugin.json). The contrast checker is also exposed as an MCP tool inside the plugin. Each skill folder also carries a short README.md that says on GitHub what the skill is for.

The First-Run Install Wizard still lives inside antislop.md as the manual path. The single-file core remains a complete filter you can paste into any chat window.

The core still contains 38 rules across three tiers (Hard Gate, Purpose-Gate, Quality Locks), a Liveliness Toolkit, a mandatory Delivery Gate, and the two usage modes (During / After). None of that changed.

How we got here

v3.0.0 was reached by adding one concern per version, each as a separate skill:

Each +0.1 version ships exactly one new skill.

That kept the filter pull-only-what-you-need and made the v3 packaging mechanical rather than a rewrite. Occasional +0.1 patches shipped something that is not a skill, like v2.4.1's plain-English guide.md; those did not change the skill plan.

The skill plan

Version Skill Concern
v2.2.0 antislop-ui UI / visual: layout, color, components, decoration, motion, structure
v2.3.0 antislop-copywriting Copy and text: headlines, CTAs, tone, fake stats, markdown hygiene
v2.4.0 antislop-human Human: contrast, keyboard, focus, states (home of the contrast checker)
v2.5.0 antislop-layoutmobile Mobile layout: responsive breakpoints, grids, overflow, tap targets, navigation
v3.1.0 antislop-code Code comments: remove generic AI-slop comments, keep the valuable ones, never touch the code

The plan to v3.0.0 is complete. antislop-code is the first skill added after v3. antislop-docs and antislop-identity remain candidates for later, not part of the shipped plan.

v3.0.0: the skill/plugin

What v3.0.0 shipped:

  • One folder per skill, skills/<name>/SKILL.md (open Agent Skills standard)
  • Two distribution doors from one repo: npx skills add miqdadbadjuber/anti-slop (skills.sh) and the .claude-plugin/plugin.json marketplace
  • A custom picker CLI (npx antislop-ai): banner, skill list with the core locked on, project or global choice, installer that writes the skill folders and the pointer
  • The contrast checker as an MCP tool inside the plugin
  • MIT license

Status

  • v2.1.0 - usage modes (During / After) and v3.0.0 banner
  • v2.1.1 - English only; Indonesian mirrors removed
  • v2.2.0 - core + First-Run Install Wizard + antislop-ui skill
  • v2.3.0 - antislop-copywriting skill
  • v2.4.0 - antislop-human
  • v2.4.1 - guide.md: plain-English guide for people new to antislop (not a skill); fixes for issues #1, #2, #3, #6, #7
  • v2.4.2 - skill checklist polarity fix (#9) and docs cleanup, merged from PRs #8 and #10
  • v2.5.0 - antislop-layoutmobile (breakpoints, scale, grids, overflow, tap targets, navigation)
  • v3.0.0 - skill/plugin packaging: skills/ folders, two doors, picker CLI, MCP contrast tool, MIT license
  • v3.0.1 - Snyk W012 fix (no runtime curl in the packaged core), npm package author to antislop, docs clarity
  • v3.0.2 - adaptive python (python3 on macOS/Linux, python on Windows), App & Dashboard + copy voice patterns, pointer fix
  • v3.1.0 - antislop-code skill, per-skill READMEs, Filler Data and Emoji as Decoration patterns

After v3

  • antislop-docs (skill candidate)
  • antislop-identity (skill candidate)
  • Cross-agent plugin (plan, no promised version): antislop installs as a plugin on more agents the way superpowers installs everywhere from one repo, with paths for Antigravity, Codex, Cursor, Gemini CLI, and others. Estimate: Q3-Q4 2026.

Not in scope

antislop stays a filter, not a style guide: no prescribed aesthetics, no per-framework recipes, no trend bans. It never beautifies on its own; direction and beauty are yours, in DESIGN.md. It is not limited to building pages: the same filter writes and audits copy (antislop-copywriting). UX and motion are folded into antislop-ui rather than separate skills, and data-integrity rules already live in the core.