deslop

Removes AI-generated code slop from branch diffs against main.

Updated Aug 15, 2025
One-click install
npx skills add https://github.com/yehezkieldio/topaz --skill deslop-yehezkieldio
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: deslop
Source: https://github.com/yehezkieldio/topaz/tree/main/.agents/skills/deslop
Command: npx skills add https://github.com/yehezkieldio/topaz --skill deslop-yehezkieldio

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? AI coding assistants often leave behind unnecessary comments, defensive checks, type casts, and deeply nested logic that clutter a codebase. This Skill reviews the diff against main and strips out that slop while preserving behavior. ## Core Features & Use Cases - Slop Detection: Identifies unnecessary comments, abnormal try/catch blocks, casts to any, and deeply nested code inconsistent with the surrounding style. - Guardrailed Cleanup: Keeps behavior unchanged unless fixing a clear bug, and prefers minimal, focused edits over broad rewrites. - Use Case: After an AI assistant implements a feature branch, run this Skill before opening a pull request to remove leftover AI artifacts and align the code with the existing codebase style. ## Quick Start Review the diff of my current branch against main and remove any AI-generated code slop while keeping behavior unchanged.

Frequently Asked Questions about deslop

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I remove AI-generated code slop from a branch?

Check the diff of your branch against main and remove unnecessary comments, abnormal defensive checks, any-type casts, and deeply nested code. Keep behavior unchanged and prefer minimal, focused edits over broad rewrites.

What counts as AI code slop in a diff?

Common slop includes extra comments inconsistent with local style, try/catch blocks abnormal for trusted code paths, casts to any used to bypass type issues, and deeply nested code that early returns would simplify.

Does cleaning up AI slop change code behavior?

No, the cleanup keeps behavior unchanged unless fixing a clear bug. The guardrails require minimal, focused edits that match the surrounding codebase style rather than broad rewrites.

When should I run a deslop pass during development?

Run it after an AI assistant finishes a feature branch and before opening a pull request. This catches leftover artifacts while the diff is still small and easy to review.

What are the limitations of automated slop removal?

It only addresses patterns visible in the diff against main and relies on judgment about local style conventions. It is not a substitute for full code review, testing, or architectural refactoring.