Deslop

🧹 Skill: deslop

Purpose

Remove low-value noise from code: comments that narrate what the code already says, unused variables and imports, and try/catch blocks that add no recovery logic. Makes the codebase easier to read and maintain.

Trigger phrases

• "deslop"
• "clean this up"
• "remove dead code"
• "strip unnecessary comments"
• "remove unused imports"

Steps

1. Determine scope

• If the user points at a file or selection, scope to that.
• If no scope given, ask: "Which file or directory should I deslop?"
• Do not deslop the entire repo unsolicited.

2. Scan for slop categories

A. Narrating comments

Comments that restate what the code does with no additional insight:

# Bad — obvious from the code
i = i + 1  # Increment i

# Bad — restates the function name
def get_user(id):
    # Get the user by ID
    return db.query(User, id)

Keep comments that explain why (non-obvious intent, trade-offs, constraints, workarounds).

B. Dead variables and imports

• Variables assigned but never read.
• Imports that are never referenced.
• Function parameters that are accepted but ignored (note: may be interface-required — flag, don't auto-delete).

C. Defensive try/catches with no recovery

# Slop — try/except that only re-raises or swallows silently
try:
    x = int(value)
except:
    pass  # no recovery, no logging

# Also slop — wraps a trivially safe operation
try:
    name = obj.name
except AttributeError:
    name = None  # could just use: name = getattr(obj, 'name', None)

Keep try/catches that: log the error, transform the exception type, implement real recovery, or wrap genuinely unsafe I/O.

D. Commented-out code blocks

• Remove blocks of code that have been commented out.
• Exception: leave a comment if the block includes a TODO or a link to an issue explaining why it's disabled.

3. Apply changes

• Make minimal edits — only remove what's clearly slop.
• Do not refactor logic, rename variables, or restructure code in a deslop pass.
• If something is ambiguous (e.g. an import that might be used dynamically), leave it and note it.

4. Report

Deslopped: <filename>

Removed:
- <count> narrating comments
- <count> unused imports: <list>
- <count> dead variables: <list>
- <count> empty/pointless try/catches

Left in place (flagged for review):
- <item> — reason

Output

Cleaned file(s) + a brief removal summary. No behaviour changes — only noise removal.

Guardrails

• Never remove the only comment explaining a non-obvious algorithm or business rule.
• Never remove imports/variables without confirming they're unused (use static analysis or grep first).
• Never change logic — if a cleanup requires a logic decision, stop and ask.