Skip to content

lootlog/monorepo / .agents/skills/deslop

deslop

Verified

Behavior-neutral cleanup of AI slop in the current branch's code diff, covering comment narration, defensive checks, type laundering, needless indirection, and style drift. Use before review or when asked to deslop a change; for prose, use `unslop`.

Deslop

Clean only the current branch diff before review. Preserve behavior absolutely.

Checklist

  1. Scope the pass to the diff against the merge base with origin/main (git diff $(git merge-base origin/main HEAD)), including uncommitted changes you own. Never run a repo-wide cleanup, and leave unrelated user changes in the working tree untouched.
  2. Inspect every changed hunk for:
    • comments a human maintainer would not write, including narration, syntax explanation, and prose that merely restates the code;
    • defensive checks or try/catch blocks that are abnormal for the surrounding module or protect only imagined states;
    • casts that launder types, especially as any and assertions whose required safety comment restates the cast instead of naming the guarantee. Oxlint's anti-slop/no-chained-type-assertions and anti-slop/no-widen-then-assert already reject as unknown as T and widen-then-assert flows;
    • redundant intermediate variables or one-use helpers that do not add domain meaning, reduce duplication, or simplify control flow;
    • memo, useMemo, or useCallback without a measured integration constraint, since React Compiler owns memoization;
    • source files that only re-export symbols;
    • compatibility shims, aliases, retries, and fallback branches without a named shipped contract and removal plan;
    • naming, control flow, imports, formatting, and other style that conflicts with the surrounding file.
  3. Make no functional edits. If cleanup could change behavior, leave it alone and report it instead.
  4. Fix a finding inline only when the cleanup is trivial and behavior-neutral. Otherwise note it for the author.
  5. After edits, run lint and typecheck for every touched workspace.
  6. Report the result in 1–3 sentences, including whether anything changed and any non-trivial item left for review.

Run deslop before the correctness review, never instead of it.

receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementationStars: 322kUpdated Claude CodeCodexVerifiedInstall
requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirementsStars: 322kUpdated Claude CodeCodexVerifiedInstall
using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallbackStars: 322kUpdated Claude CodeCodexVerifiedInstall
verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions alwaysStars: 322kUpdated Claude CodeCodexVerifiedInstall