SKILL.md
Deslop
Use this workflow when code on the current branch contains visibly generated boilerplate that makes maintenance harder but does not represent real behavior.
Workflow
- List changed files and read the diff before editing.
- Look for common slop signatures:
- comments that restate the next line - broad except Exception wrappers that add no handling - private docstrings longer than the code they describe - "helper" functions used exactly once - defensive checks for states the type system or caller contract rules out - conversation-bound comments such as "added for this issue" - verbose variable names that obscure simple logic
- Preserve genuine boundary handling for HTTP, subprocesses, file IO, parsing, and user input.
- Remove only noise whose behavior impact is clearly zero.
- Run targeted tests or checks for the touched files.
- If a removal might change observability or error behavior, leave it as a proposal.
Final Report
Include:
- files cleaned
- slop categories removed
- tests or checks run
- proposals not applied
- residual risks