This skill identifies and removes AI-generated code slop from changes in the current branch.
Process
1. Get the Diff
Run git diff main...HEAD to see all changes introduced in this branch.
2. Analyze Each Changed File
For each file with changes, look for these patterns of AI slop:
Unnecessary Comments
- Comments explaining obvious code that a human wouldn't add
- Comments inconsistent with the rest of the file's commenting style
- JSDoc or docstrings added to simple internal functions that don't have them elsewhere
- "// TODO" or "// NOTE" comments that aren't actionable
Defensive Over-Engineering
- Try/catch blocks in internal code paths that are already validated upstream
- Null/undefined checks on values that are guaranteed to exist by the type system or calling context
- Fallback values that can never be reached
- Type guards on already-typed parameters
Type Workarounds
- Casts to
anyto bypass type errors @ts-ignoreor@ts-expect-errorcomments- Overly broad union types to satisfy the compiler
Style Inconsistencies
- Different naming conventions than the rest of the file
- Different formatting patterns (even if valid)
- Excessive blank lines or grouping that doesn't match file style
- Console.log statements left in production code
3. Clean Up
For each identified issue:
- Read the surrounding context to understand the file's existing style
- Remove or simplify the slop while preserving actual functionality
- Ensure the code still works correctly
4. Report
After all changes, provide a 1-3 sentence summary of what was changed. Do not enumerate every change—just summarize the types of slop removed and roughly how much.
Example output:
Removed 12 unnecessary comments explaining obvious code and 3 redundant try/catch blocks in API handlers. Also cleaned up 2 any casts that were hiding actual type issues.