Declutter

Refactors code by removing unused imports, variables, methods, redundant comments, and fixing formatting, with automatic test runs and commits after each step.

SDiamante13 Updated 7 repo stars

File contents

Declutter Refactor

Ask the user for the file or directory to refactor. Support multiple files if a directory is provided.

Process

Work through these steps in order, making a separate commit for each step that finds issues:

  1. Remove unused imports
  2. Remove unused variables
  3. Remove unused methods
  4. Remove redundant/unnecessary comments
  5. Fix inconsistent formatting

After EACH step:

  • Run tests automatically
  • If tests fail, revert the change immediately
  • If tests pass and changes were made, commit using Arlo's Commit Notation: . r <brief description>
  • If no issues found in that category, skip silently to next step

Output

Provide a brief summary at the end listing what was removed (e.g., "Removed 3 unused imports, 2 unused methods").

Commit Format

Use Arlo's Commit Notation (ACN):

  • Format: . r <description>
  • Example: . r remove unused imports
  • The . indicates "proven safe" (tests passed)
  • The r indicates refactoring

SDiamante13/dotfiles/tree/main/claude/skills/refactor/declutter commit 336b4dc02c

Frequently asked questions

npx skillmds@latest add sdiamante13/declutter