Slop Detector

Slop Detector


**AI-powered code quality enforcement for GitHub — identify slop, block it from reaching production, and get actionable feedback on every commit.**

**Full documentation:** [DOCS.md](./DOCS.md) — covers architecture, local testing, threshold tuning, troubleshooting, security considerations, and complete configuration reference.

---

Overview

Slop Detector is an AI-powered GitHub Actions workflow that acts as an automated code quality gate on every push. It catches low-effort, careless, or AI-generated code collectively known as "slop" — before it reaches your main branch, production environment, or your teammates' code review queue.

**Identify slop.** Every commit is analysed by a Gemini-powered [Swarms](https://github.com/kyegomez/swarms) agent trained to think like a principal engineer. It reads the diff, scores it from `0.0` (pristine) to `1.0` (catastrophic), and surfaces every specific violation — missing types, undocumented functions, placeholder logic, and AI-generated noise — with precise line references.

**Prevent slop from reaching production.** When