slop-guard | From Slop to Signal
Description: slop-guard is a rule-based prose linter for formulaic AI writing. Run it with uvx, install sg, or wire it into Codex and Claude as an MCP server.

# Catch slop before it lands in your docs.

`slop-guard` is a rule-based prose linter for formulaic AI writing. It scores text from 0 to 100, points to the exact spans that dragged the score down, and returns direct advice for the rewrite.

No LLM judge. No API calls. No cost.

Run Once

    uvx --from slop-guard sg README.md

Install The CLI

    uv tool install slop-guard

Add To Codex

    codex mcp add slop-guard -- uvx slop-guard

Add To Claude Code

    claude mcp add slop-guard -- uvx slop-guard

From Slop To Clean

0 / 100 to 100 / 100
crucial groundbreaking paradigm unlock
specific measured direct concrete clear

## Features

Score

### 0-100 banding

Clean, light, moderate, heavy, or saturated. The score is compact enough for a terminal and sharp enough for a CI floor.

18
saturated heavy moderate light clean

Matches

### Exact spans

Violations come back with the matched text, surrounding context, and penalty. You can point at the problem instead of arguing about vibes.

Ship the groundbreaking update with actionable notes and a clear rollout plan.

exact span | -2 Replace stock phrasing with a concrete claim.

Advice

### Rewrite prompts

The output tells you what to cut and what kind of wording to replace it with, so the rewrite is faster than a blank restart.

crucial paradigm leverage
rewrite
specific direct measured

Agent Workflow

### Inside Codex or Claude

Add `slop-guard` as an MCP server and let the agent call `check_slop` or `check_slop_file` while it drafts docs, release notes, or project updates.

Codex Claude Code
check_slop check_slop_file
mcp add slop-guard -- uvx slop-guard

CLI + CI

### Run it locally or fail the build

Use `sg` on files, inline text, or stdin. Add a threshold in CI and low-scoring prose exits non-zero before it ships.

$ sg -t 60 docs/*.md

docs/api.md 88

docs/landing.md 54

exit 1 threshold 60

Custom Rules

### Fit it to your own style

Train a JSONL rule config from positive and negative corpora, then point the CLI and MCP server at the fitted rules for your own house style.

positive/*.md guides/*.md
negative/*.md slop/*.md
rules.fitted.jsonl

Start Here

## Keep the draft. Lose the filler.

Wire `slop-guard` into Codex or Claude Code, then let the agent lint the writing before it ships.

    codex mcp add slop-guard -- uvx slop-guard
    claude mcp add slop-guard -- uvx slop-guard

View the repository