anti-slop

# Anti-Slop Skill

Detect and eliminate generic AI-generated patterns ("slop") across natural language, code, and design.

## What is AI Slop?

AI slop refers to telltale patterns that signal low-quality, generic AI-generated content:
- **Text**: Overused phrases like "delve into," excessive buzzwords, meta-commentary
- **Code**: Generic variable names, obvious comments, unnecessary abstraction
- **Design**: Cookie-cutter layouts, generic gradients, overused visual patterns

This skill helps identify and remove these patterns to create authentic, high-quality content.

## When to Use This Skill

Apply anti-slop techniques when:
- Reviewing AI-generated content before delivery
- Creating original content and want to avoid generic patterns
- Cleaning up existing content that feels generic
- Establishing quality standards for a project
- User explicitly requests slop detection or cleanup
- Content has telltale signs of generic AI generation

## Core Workflow

### 1. Detect Slop

**For text files:**
```bash
python scripts/detect_slop.py <file> [--verbose]
```

This analyzes text and provides:
- Slop score (0-100, higher is worse)
- Specific pattern findings
- Actionable recommendations

**Manual detection:**
Read the appropriate reference file for detailed patterns:
- `references/text-patterns.md` - Natural language slop patterns
- `references/code-patterns.md` - Programming slop patterns  
- `references/design-patterns.md` - Visual/UX design slop patterns

### 2. Clean Slop

**Automated cleanup (text only):**
```bash
# Preview changes
python scripts/clean_slop.py <file>

# Apply changes (creates backup)
python scripts/clean_slop.py <file> --save

# Aggressive mode (may slightly change meaning)
python scripts/clean_slop.py <file> --save --aggressive
```

**Manual cleanup:**
Apply strategies from the reference files based on detected patterns.

## Text Slop Detection & Cleanup

### High-Priority Targets

**Remove immediately:**
- "delve into" → delete or replace with "ex