Rules for an AI coding agent to filter out generic AI-generated UI designs, text, and code.
JavaScript accessibilityagent-skillsai-agentsai-coding-agentai-slopanti-slopclaude-codecopywritingdesign-rulesui-design
v3.2.11: Codex global installs, a corrected shared-folder claim, and two queued agent slots
miqdadbadjubereece033d2727
diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.jsonindex 16870e3..7e09a5f 100644--- a/.claude-plugin/marketplace.json+++ b/.claude-plugin/marketplace.json@@ -8,7 +8,7 @@{"name": "antislop","source": "./",- "version": "3.2.10",+ "version": "3.2.11","description": "Anti Slop: Rules for AI Coding Agents. Stops generic AI slop in generated UI, copy, and code. Loads as six skills."}]diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.jsonindex 0214857..4273960 100644--- a/.claude-plugin/plugin.json+++ b/.claude-plugin/plugin.json@@ -1,7 +1,7 @@{"name": "antislop","displayName": "antislop",- "version": "3.2.10",+ "version": "3.2.11","description": "Anti Slop: Rules for AI Coding Agents. Stops generic AI slop in generated UI, copy, and code. Loads as six skills.","author": {"name": "miqdadbadjuber"diff --git a/.codex-plugin/plugin.json b/.codex-plugin/plugin.jsonindex fdf6b79..0945630 100644--- a/.codex-plugin/plugin.json+++ b/.codex-plugin/plugin.json@@ -1,6 +1,6 @@{"name": "antislop",- "version": "3.2.10",+ "version": "3.2.11","description": "Anti Slop: Rules for AI Coding Agents. Stops generic AI slop in generated UI, copy, and code. Loads as six skills.","author": {"name": "miqdadbadjuber"diff --git a/.cursor-plugin/plugin.json b/.cursor-plugin/plugin.jsonindex a2ba091..d16ebda 100644--- a/.cursor-plugin/plugin.json+++ b/.cursor-plugin/plugin.json@@ -2,7 +2,7 @@"name": "antislop","displayName": "antislop","description": "Anti Slop: Rules for AI Coding Agents. Stops generic AI slop in generated UI, copy, and code. Loads as six skills.",- "version": "3.2.10",+ "version": "3.2.11","author": {"name": "miqdadbadjuber"},diff --git a/README.md b/README.mdindex 7036b08..804f67c 100644--- a/README.md+++ b/README.md@@ -189,14 +189,12 @@ antislop is used one of two ways, chosen at the start of a session:## Roadmap-**v3.2.10** is the current release.--- **GitHub Copilot is an installer target.** It loads skills from `.github/skills`, `.claude/skills`, or `.agents/skills`, so it shares the `.agents/skills` folder other agents already use and reads the same `AGENTS.md` pointer. No new folder, no new file. GitHub's skill support is young, so treat this door as early.-- **The installer stops writing the same skills twice.** Agents that share a folder now share one install instead of one each, and the conflict prompt counts folders rather than agents, so it stops reporting more folders than exist.-- **OpenCode gets told about a collision.** OpenCode reads `.opencode/skills`, `.claude/skills`, and `.agents/skills` at once and documents no precedence between them. When two of those hold antislop, the installer now names both instead of leaving you to find a missing skill later.-- **Claude Code and `AGENTS.md`.** Since v2.1.277 Claude Code reads `AGENTS.md` when a project has no `CLAUDE.md`. antislop keeps writing `CLAUDE.md`, because a `CLAUDE.md` anywhere above the working directory makes Claude ignore `AGENTS.md` entirely.-- **Copilot has no plugin door.** The roadmap promised a marketplace command; there is none to ship, because Copilot Extensions in the GitHub Marketplace are applications rather than repo manifests.-- **R-02 stops contradicting itself.** The core called the em dash ban absolute, while `antislop-copywriting` excepted a user's own voice in three places, so the most recognisable AI tell could survive the filter. R-02 now scopes the ban to text the agent writes, and a user's sample goes through R-37 instead: name it, ask, never decide silently.+**v3.2.11** is the current release.++- **A global Codex install moves to the folder Codex documents.** It wrote `~/.codex/skills`, which Codex's own source calls its deprecated user location, and now writes `$HOME/.agents/skills`. The old path still loads, so an existing install keeps working.+- **Codex learns about the shared-folder collision.** Codex walks `.agents/skills` up from the working directory, so installing Codex and Copilot into one project leaves two copies of the same skill names. The installer now names that, where it used to stay silent.+- **The shared-folder claim is corrected.** This page said Copilot was the one agent that reads the home-level `.agents/skills/`. Codex reads it at user scope and OpenCode lists it beside its own global folder, so it is three agents, and README, GUIDE and ROADMAP now say which agents do.+- **A star history chart** sits between the FAQ and the contributors.Every earlier release, and what comes next, is in [ROADMAP.md](ROADMAP.md).diff --git a/ROADMAP.md b/ROADMAP.mdindex 571a95a..9d795af 100644--- a/ROADMAP.md+++ b/ROADMAP.md@@ -4,7 +4,7 @@## Where we are-The latest release is **v3.2.10**. antislop is a **packaged system**: a lean, always-loaded core plus five additive skills, each shipped as a standard agent skill folder (`skills/<name>/SKILL.md`). There are no per-skill READMEs.+The latest release is **v3.2.11**. antislop is a **packaged system**: a lean, always-loaded core plus five additive skills, each shipped as a standard agent skill folder (`skills/<name>/SKILL.md`). There are no per-skill READMEs.- **The core: 38 rules** across three tiers (Hard Gate, Purpose-Gate, Quality Locks), a Liveliness Toolkit, a mandatory Delivery Gate, and two usage modes (During / After). The count has held since v2.2 and the tiers have not moved, but individual rules have been sharpened many times since, and the release history below says where. The single-file `antislop.md` is still a complete filter you can paste into any chat window; its First-Run Install Wizard is the manual install path.- **The six skills:** `antislop` (the core), plus `antislop-ui`, `antislop-copywriting`, `antislop-human`, `antislop-layoutmobile`, and `antislop-code`. Each skill only loads when the task needs it.@@ -48,6 +48,7 @@ That kept the filter pull-only-what-you-need and made the v3 packaging mechanica| v3.2.8 | Repair round, from a full re-validation of every shipped door against its vendor's current documentation. Antigravity's global install moves to `~/.gemini/config/skills/`: it had been writing the home-level `.agents/skills/`, which Antigravity does not read, so global installs aimed at Antigravity since v3.2.0 landed in a folder it never enumerates. The entry-file writer ignores markers that sit inside a code fence, keeps the author's line endings, no longer appends a fresh block on every run when one marker is unmatched, and no longer deletes the rest of the file when a `start` marker has no matching `end`. The installer refuses to run without a terminal, where it used to print its prompts, install nothing, and exit 0. OpenCode's global folder moves to the documented `~/.config/opencode/skills/`, where the old `~/.opencode/skills/` still loads, so nothing was broken there. Docs corrected wherever they disagreed with the code. || v3.2.9 | Hermes gets its project scope, and the install documentation is rewritten end to end. Hermes does read a project's skills, so the installer now writes `<project>/.hermes/skills/` and the `AGENTS.md` pointer, where it used to force every Hermes install into `~/.hermes/`; a project's skills also outrank the global ones, which the old behaviour could never reach. Hermes will not load skills out of a cloned repository until that repository is trusted, a deliberate vendor gate the installer must not bypass, so the installer names the one-time `hermes skills trust` step and the guide documents it, along with the version caveat: the official installer has project discovery and the older PyPI `hermes-agent` package does not. Cursor's install command is corrected, because `/add-plugin <url>` appears in no Cursor documentation and not in the shipped CLI bundle; the documented route is `agent plugin marketplace add <url>` followed by Install in the Customize panel. The installer's conflict prompt now distinguishes the choice that updates from the one that silently leaves the old version in place, and its closing line says so when it keeps existing folders. The guide is rebuilt around what the reader is doing rather than which tool they picked: Install, Update, and Remove are separate top-level sections, each covering the same four routes in the same order, so finding a route in one finds it in the others, and the parts that are reference rather than steps are collected under a Reference heading. Update and removal steps, which previously sat inside each route as bold text with no heading of their own, now have a section of their own for every route. Install gains step-by-step walkthroughs for both main routes and a phone and chat-window section. A live generate-test also produced two content fixes. "Eyebrow Badge Above the Headline" joins the pattern list: a pill parked directly above the H1, usually with a dot, holding a category label the headline already says, which slipped between R-09 (whose forbidden content list stops at "AI Powered", "Beta", "New") and Decorative Status Dot (which opens with a glowing, pulsing dot). And the core now states outright that three steps run in both usage modes whatever else is driving the session: direction resolution (R-37), asset clarification (R-23), and the Delivery Gate. The test that surfaced them ran another skill's planning workflow, which led the work while antislop's mandatory steps went unrun, including the gate report. The README also gains a comparison section, eight images drawn from one brief. Three page builds sit in a row, each captioned underneath in its own cell, followed by the fourth at full width as the payoff: with nothing, with antislop alone, with `DESIGN.md` alone, and then both together. They are separate outcomes rather than a before and after, because each one is a different set of tools rather than a stage of the same work, and none of them has to be read off a grid. Copy and code comments get before-and-after pairs instead, since there the filter is the whole of the job. || v3.2.10 | GitHub Copilot joins as an installer target, and the installer stops treating one agent as one folder. Copilot loads skills from `.github/skills`, `.claude/skills`, or `.agents/skills`, so it needs no folder of its own and no pointer of its own: it shares `.agents/skills` with Antigravity and reads the `AGENTS.md` block five other agents already get. The skill format it requires is the one antislop already ships, so the whole door is one installer row. The roadmap's promised plugin marketplace command is dropped instead of shipped, because Copilot has no repo-installable plugin manifest: Copilot Extensions in the GitHub Marketplace are applications, a different mechanism from the Claude Code and Cursor doors. Sharing a folder exposed a bug the old model could not express. `resolveTargets` returned one target per agent, so eight agents resolving to seven folders copied the same skills twice into one folder and reported twice the folders that existed in the conflict prompt; it now groups by resolved path and carries every agent that lands there, which is also what lets the next `.agents/skills` reader in the queue cost one row. The same mistake runs the other way. OpenCode loads skills from `.opencode/skills`, `.claude/skills`, and `.agents/skills`, so a project that installs into two of them holds the same skill names twice, and OpenCode documents no precedence between its roots. Its loader has been reported to choose between duplicate names non-deterministically and to collapse them into one candidate, which is how a skill goes missing after an install that looked correct, so the installer now names that collision and says which folders to remove. Documentation is corrected as well. Copilot is added wherever the agents are listed, the claim that nothing reads the home-level `.agents/skills/` is withdrawn because Copilot does, and Claude Code's `AGENTS.md` support is recorded with the reason antislop still writes `CLAUDE.md`: since v2.1.277 Claude reads `AGENTS.md` only when no `CLAUDE.md` exists in the working directory or above it, so an `AGENTS.md`-only pointer would be silently ignored in any project that has one. Copilot support is young on GitHub's side, so the release notes say so. A conflict inside the rules themselves was reported and fixed in the same round. R-02 bans the em dash from Hard Gate, which the core calls absolute, while `antislop-copywriting` granted that ban an exception in three places, so an agent loading both had to resolve "FAIL regardless of purpose" against "the voice wins" and resolved toward the exception: the tell survived the filter built to remove it. R-02 now states its scope instead. The ban governs text the agent writes, and a user's own writing sample is a direction rather than agent copy, so a sample that uses em dashes goes through R-37's conflict protocol, which names the character and asks rather than letting either file decide silently. The exception is gone from all three places and the Delivery Gate item no longer fails a sample the owner approved. |+| v3.2.11 | Repair round, from the community's reports rather than a re-validation sweep. A global Codex install wrote `~/.codex/skills`, the location Codex's own source names as the user path it is moving off while documenting `$HOME/.agents/skills` beside it, so the Codex row gains that global folder; the old path still loads, so an existing install keeps working. The same row gains `readsAlso: ['.agents/skills']`, which Codex walks up from the working directory: without the field, installing Codex and Copilot into one project left two copies of the same skill names and the collision warning stayed silent for Codex. The smoke test's global-targets line printed the two paths and compared nothing, so it now asserts them and fails when the new folder is removed. The previous release narrowed the shared-folder claim to "Copilot is the one agent that reads the home-level `.agents/skills/`", which is wrong: Codex reads it at user scope and OpenCode's own documentation lists it beside its global folder, so three agents read it rather than one, and README, GUIDE and ROADMAP now name them. A star history chart joins the README between the FAQ and the contributors. Three pending pull requests are answered rather than merged: a saved usage-mode preference goes back to its author for a Windows settings path and a fresh-session proof, and the Pi and Oh My Pi doors are queued into slots of their own, because a maintenance round ships no new agent. |## What's next@@ -61,12 +62,13 @@ Every door is verified against the vendor's current documentation before its ver| Version | Item | What it means ||---------|------|---------------|-| v3.2.11 | Maintenance | No new agent. Re-validate every door against its vendor's current documentation and the community's reports, then repair what drifted. The slot is fixed; the list is decided at the time, from what those checks surface. || v3.2.12 | Kimi Code | The installer row and its pointer. Moonshot also ships a plugin system and Kimi Code reads `.agents/skills/`, so the door class is decided when its current documentation is read rather than promised here. || v3.2.13 | Maintenance | No new agent. The same re-validation round. || v3.2.14 | Cline | One `.agents/skills` reader, confirmed on its own rather than assumed from the shared folder. || v3.2.15 | Amp | The next one, confirmed the same way. Cline and Amp are separate versions because a door that breaks should only ever be one agent's problem. || v3.2.16 | Maintenance | No new agent. The same round again. |+| v3.2.17 | Pi | The installer row, the `AGENTS.md` pointer, and the root `package.json` that makes this repo a Pi package. Oh My Pi is a fork of Pi and reads the same `pi` key, so this door is also what makes the repo discoverable there. |+| v3.2.18 | Oh My Pi | The marketplace catalog, if the Pi door above has not already covered the plugin path. Every catalog entry carries a version, because Oh My Pi's update checker permanently skips entries that lack one. |Beyond the numbered plan, with no promised version:diff --git a/cli/index.mjs b/cli/index.mjsindex 0677f8d..977c3b9 100644--- a/cli/index.mjs+++ b/cli/index.mjs@@ -36,7 +36,7 @@ function displayDir(agent, location) {async function main() {if (process.argv.includes('--version') || process.argv.includes('-v')) {- console.log('antislop 3.2.10')+ console.log('antislop 3.2.11')return}diff --git a/cli/lib/banner.mjs b/cli/lib/banner.mjsindex fb4dcae..b3af4cd 100644--- a/cli/lib/banner.mjs+++ b/cli/lib/banner.mjs@@ -15,7 +15,7 @@ export function banner() {...LOGO,'',' ' + pc.dim('Anti Slop: Rules for AI Coding Agents'),- ' ' + pc.dim('installer v3.2.10'),+ ' ' + pc.dim('installer v3.2.11'),'',].join('\n')}diff --git a/cli/package-lock.json b/cli/package-lock.jsonindex d930b1d..fe05266 100644--- a/cli/package-lock.json+++ b/cli/package-lock.json@@ -1,12 +1,12 @@{"name": "antislop-ai",- "version": "3.2.10",+ "version": "3.2.11","lockfileVersion": 3,"requires": true,"packages": {"": {"name": "antislop-ai",- "version": "3.2.10",+ "version": "3.2.11","license": "MIT","dependencies": {"@clack/prompts": "^1.7.0",diff --git a/cli/package.json b/cli/package.jsonindex 859d63f..192b895 100644--- a/cli/package.json+++ b/cli/package.json@@ -1,6 +1,6 @@{"name": "antislop-ai",- "version": "3.2.10",+ "version": "3.2.11","description": "Interactive installer for the antislop skills. Anti Slop: Rules for AI Coding Agents.","type": "module","bin": {diff --git a/skills/antislop-human/contrast-mcp.py b/skills/antislop-human/contrast-mcp.pyindex 7269f19..fe83ec3 100644--- a/skills/antislop-human/contrast-mcp.py+++ b/skills/antislop-human/contrast-mcp.py@@ -8,7 +8,7 @@ import sysPROTOCOL_VERSION = "2024-11-05"SERVER_NAME = "antislop-contrast"-SERVER_VERSION = "3.2.10"+SERVER_VERSION = "3.2.11"TOOLS = [{