# Antislop Code

Code comment hygiene for AI coding agents: remove generic AI-slop comments, keep the...

- Repository: https://github.com/miqdadbadjuber/anti-slop (7917 stars)
- Category: AI and agents
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add miqdadbadjuber/anti-slop --skill antislop-code -g -a claude-code -y`
Codex: `npx skills add miqdadbadjuber/anti-slop --skill antislop-code -g -a codex -y`
Cursor: `npx skills add miqdadbadjuber/anti-slop --skill antislop-code -g -a cursor -y`
Gemini CLI: `npx skills add miqdadbadjuber/anti-slop --skill antislop-code -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add miqdadbadjuber/anti-slop`

## Description

Code comment hygiene for AI coding agents: remove generic AI-slop comments, keep the valuable ones, never touch the code.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# antislop-code

> Anti Slop: Rules for AI Coding Agents. Code Comments skill

> Part of the antislop system. Read together with `antislop.md` (the core). This skill filters comments that read as generically AI (decorative, restating the obvious, stiff, loud) while preserving the comments that carry real information. It references core rules by number and never duplicates or renumbers them. Load it when the task writes or edits code comments.

## How to use this skill

- Load together with `antislop.md` whenever the task touches code comments. The core holds the mechanism (the purpose test, the three tiers, the Delivery Gate); this skill holds comment-specific depth.
- Every entry has the same shape: **Tell** (the pattern), **Why** (why it reads as slop), **Fix** (what to do instead), with the governing core rule cited as R-XX.
- **Scope guardrail:** this skill only modifies comments. Never modify executable code, identifiers, imports, formatting, indentation, whitespace, control flow, or logic. When in doubt, leave the code untouched.
- The Delivery Gate in the core remains the gate. The "Code Comment Checklist" at the end of this file is the comment-specific supplement to run alongside it.

## Comments That Add Nothing

### Decorative Separators

- **Tell:** banner comments built from repeated characters, ALL CAPS labels, or box drawing around a section name: `// =======================` around `Authentication`, `// -------- WORKFLOW --------`, or a `/* ---- ROUTES ---- */` header.
- **Why:** the decoration is the message. A label wrapped in `=` or `-` signals "AI made this" without adding information, and ALL CAPS reads as shouting.
- **Fix:** replace with a single plain line, or remove entirely if the label adds nothing (R-31).

### Restating the Obvious

The rest: https://github.com/miqdadbadjuber/anti-slop/blob/HEAD/skills/antislop-code/SKILL.md