Pro-workflow deslop
Remove AI-generated code slop, unnecessary comments, and over-engineering from the current branch diff. Cleans up boilerplate, simplifies abstractions, and strips defensive code. Use when cleaning up code, simplifying, removing boilerplate, or before committing.
install
source · Clone the upstream repo
git clone https://github.com/rohitg00/pro-workflow
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/rohitg00/pro-workflow "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/deslop" ~/.claude/skills/rohitg00-pro-workflow-deslop && rm -rf "$T"
manifest:
skills/deslop/SKILL.mdsource content
Remove AI Code Slop
Check the diff against main and remove AI-generated slop introduced in the branch.
Trigger
Use after completing changes, before committing, or when code feels over-engineered.
Commands
git fetch origin main git diff origin/main...HEAD --stat git diff origin/main...HEAD
Workflow
- Run diff commands to see all changes on the branch.
- Identify slop patterns from the focus areas below.
- Apply minimal, focused edits to remove slop.
- Re-run
to verify only slop was removed.git diff origin/main...HEAD - Run tests or type-check to confirm behaviour unchanged:
npm test -- --changed --passWithNoTests 2>&1 | tail -10 - Summarise what was cleaned.
Focus Areas
- Extra comments that state the obvious or are inconsistent with local style
- Defensive try/catch blocks that are abnormal for trusted internal code paths
- Casts to
used only to bypass type issuesany - Over-engineered abstractions for one-time operations (premature helpers, factories)
- Deeply nested code that should be simplified with early returns
- Backwards-compatibility hacks (renamed
, re-exports,_vars
comments)// removed - Features, refactoring, or "improvements" beyond what was requested
- Added docstrings, type annotations, or comments on code that wasn't changed
- Error handling for scenarios that can't happen in trusted internal paths
Guardrails
- Keep behavior unchanged unless fixing a clear bug.
- Prefer minimal, focused edits over broad rewrites.
- Three similar lines of code is better than a premature abstraction.
- If you remove something, verify it's truly unused first.
- Keep the final summary concise (1-3 sentences).
Output
- List of slop patterns found with file locations
- Edits applied
- One-line summary of what was cleaned