Skip to content
Development
Skill

/deslop

Remove AI slop (fabricated casts, evidence widening, defensive clutter, mock patching, vacuous names) from recent changes while keeping tests green. Use when the user asks to de-slop, clean up AI-generated code, or remove defensive clutter from a diff.

From plugin
dotclaude
59687 skills7 agents4 commands3 MCP

Claude Code

$ npx -y skills add FradSer/dotclaude --skill deslop --agent claude-code

SKILL.md

deslop.SKILL.md
name: deslop
description: "Remove AI slop (fabricated casts, evidence widening, defensive clutter, mock patching, vacuous names) from recent changes while keeping tests green. Use when the user asks to de-slop, clean up AI-generated code, or remove defensive clutter from a diff."

De-slop

Remove AI slop from a bounded change set without changing behavior. AI slop is the set of low-evidence, low-signal patterns that language-model-generated code tends to emit under completion pressure: fabricated evidence, discarded type information, defensive clutter, test-cheating seams, and vacuous names. The categories are language-neutral: apply them to whatever stack the change set touches.

Run this as a focused pass over a diff, an uncommitted change set, or named files. Never add features, never change public behavior, and never trade a working product for cleanup. Tests and types must stay green; if the change set has no test coverage, report that and stop before rewriting anything.

The five slop categories

Each category reads *what it is* → *how to fix it*. Match them against the change set:

  • **Fabricated evidence**: casts, suppressions, or unsafe escapes that assert a type or invariant the code never established: chained `as`/`as unknown as`, `cast(Any, x)`, `# type: ignore`, `@ts-ignore`/`@ts-expect-error` without justification, `unsafe` blocks or `.unwrap()` standing in for real handling, non-null `!` assertions on nullable values. → Replace with boundary parsing, type guards, or pattern matching; when a suppression is genuinely required, pair it with a non-empty invariant justification.
  • **Evidence widening**: known, precise values funneled into top types or open dictionaries: parameters and returns typed `object`/`unknown`/`any`/`interface{}`/`dict[str, Any]`, finite records degraded to open maps, `as any` to silence a mismatch. → Preserve the precise type end to end; widen only at an unparsed boundary and parse there.
  • **Defensive clutter**: no-op protection against cases a trusted codepath cannot produce: `try/except: pass`, redundant null checks inside internal call chains where the value is guaranteed, conditional empty-object spreads and similar omission tricks, silent fallback defaults. → Delete the check; validate at the boundary once instead of everywhere.
  • **Mock patching**: tests that monkey-patch or mock a module's internals to force the code under test to pass: `patch("module.path")` on the subject's own collaborators, `vi.mock`/`jest.mock` on internal modules, snapshots derived from the implementation. → Test through real seams: inject an adapter, point the code at an in-memory implementation, or exercise the public interface.
  • **Vacuous names**: symbols named after their type or shape instead of their domain meaning: `data`, `info`, `item`, `result`, `obj`, `helper`, `manager`, `*Shape`, `handleX`. → Rename to the domain concept the symbol carries; if no honest name exists, the design is murky and that is a finding, not a rename.

Two binding rules:

  • **Repo tooling overrides.** If the repository enforces a category through lint or CI, skip it here: tooling already rejects it, and duplicating it wastes effort.
  • **Behavior is frozen.** Every rewrite must keep observable behavior, public interfaces, and test outcomes identical. A de-slop pass that requires a behavior change is out of scope: record it as a finding instead.

Process

1. Pin the scope

Resolve the change set before touching anything:

  • If the user named a diff base, files, or a review request, use that.
  • Otherwise use the uncommitted change set (`git status` plus `git diff`).
  • An empty scope is a stop: report that there is nothing to de-slop.

2. Inventory findings

For a compound guard, justify each predicate separately by tracing the exact expression and conversion order on a concrete input. A failure rejected by another predicate does not prove this one necessary. If no distinguishing input is established, record the claimed necessity as unverified rather than converting a redundant check into a proven requirement. Removing a proven inert predicate preserves the accepted grammar and does not require changing the spec or obtaining a new product decision. Reconcile cleanup, review and handoff verdicts against the final candidate after remediation.

Scan the scope once per category. Produce a findings list: category, location (file plus hunk), the offending line quoted, and the replacement plan. A finding without a concrete replacement plan is not ready to fix: leave it as a reported finding.

3. Rewrite

Apply the plans in one pass, category by category. For each rewrite:

1. Replace the slop with the typed, seam-based, or renamed equivalent. 2. Keep tests green after each category batch; run the repository's test suite or the affected subset between batches. 3. Stop and report when a planned rewrite cannot keep tests green: the slop was load-bearing, which is itself a finding.

4. Verify

Run the verification the repository already uses: tests, typecheck, and lint. A de-slop pass ends green or it has not ended. Record each actually failed command and its observed result separately from reasoning about an unexecuted alternative. Do not describe a rejected design, source inspection or hypothetical regression as a test failure unless that candidate was executed and failed. Label untested conclusions and preserve the real verification sequence in cleanup and handoff notes. Reconcile the summary, findings, verdict and handoff against that sequence before finishing; remove contradictory counts or claims about failed attempts.

5. Verdict

Report under three headings:

  • **Removed**: each rewrite as `category → file:line → one-line replacement summary`.
  • **Findings**: slop that could not be removed without a behavior change, test coverage, or a design decision, each with the reason.
  • **Skipped**: categories skipped because repository tooling already enforces them.

En

Read more
@fradser
Ships withdotclaude

A curated collection of 23 plugins for Claude Code, providing specialized agents, skills, and automation tools for development and productivity workflows.

59687 skills7 agents3 MCP
Get the whole plugin

Stars on GitHub

Momentum

stars in total
596
Star history of FradSer/dotclaude on GitHub, a chart by star-history.com

Other skills on dotclaude.

use-acpx

use-acpx

Use acpx as a headless ACP CLI for agent-to-agent communication, always inside an isolated SubAgent. Use when running coding…

@fradser@fradserInstall Skill
delegate

delegate

Delegates a self-contained task to a Google Gemini Managed Agent (Antigravity) running in a remote sandbox with code execution,…

@fradser@fradserInstall Skill
research

research

Runs a deep-research query on Google Gemini's deep-research managed agent and returns a cited report. This skill should be used…

@fradser@fradserInstall Skill
code-context

code-context

This skill should be used when the user asks to "understand a codebase", "get code context", "research a library", "explore a…

@fradser@fradserInstall Skill
get-context

get-context

Execute this when the user requests code context for a repository, library, or any natural-language code/technology question…

@fradser@fradserInstall Skill

More skills from other plugins.

brainstorming
Auto-invoked

brainstorming

You MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or…

@obra@obraInstall Skill
ask-matt

ask-matt

Ask which skill or flow fits your situation. A router over the skills in this repo.

skills2w309k
@mattpocock@mattpocockInstall Skill
accessibility
Auto-invoked

accessibility

Design, implement, and audit accessible UI to WCAG 2.2 Level AA across Web, iOS, and Android — semantic ARIA roles and labels,…

ecc2w293k
@affaan-m@affaan-mInstall Skill
compiler-commit

compiler-commit

Use when you want to verify compiler changes and commit with the correct convention. Runs tests, lint, and format, then commits…

react6d252k
@facebook@facebookInstall Skill

Questions about deslop.

Which coding agents can use deslop?
deslop installs in Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode and Windsurf with the skills CLI, using each agent's flag shown on this page. Flowy's auto-invocation, which fires a skill when your prompt matches, runs in Claude Code only.