Does this skill work across the entire codebase?

Yes, it is specifically designed to perform bulk changes and updates across many files simultaneously while maintaining consistency.

How does it verify that the tasks were completed correctly?

The subagent uses a TodoWrite system to track its progress and iterates on files until the relevant linters or diagnostics confirm the issues are resolved.

Can it handle complex architectural changes?

No, tasks requiring high-level design decisions should stay with the main agent; this skill is optimized for mechanical, non-creative bulk changes.

What is the code-janitor subagent?

It is a specialized agent launched by the Code Cleanup skill to handle mechanical, repetitive tasks while preserving the main agent's context for more complex work.

When should I use the Code Cleanup skill?

Use it for 'janitorial' tasks like fixing formatting, batch renaming variables, or resolving IDE diagnostics and linting errors across multiple files.

Code Cleanup & Refactoring

Name: Code Cleanup & Refactoring
Author: krmcbride

bykrmcbride

•

Developer Tools

Automates repetitive, mechanical code maintenance tasks like linting fixes and bulk renaming to preserve developer context.

About

This skill delegates mechanical and repetitive coding chores to a specialized subagent, allowing the primary Claude agent to focus on complex architectural decisions and logic. It excels at handling bulk changes such as fixing linting errors across multiple files, updating import statements, and performing consistent variable renames. By offloading these low-level tasks, it ensures that project-wide formatting and style violations are resolved efficiently without draining the main agent's context window or cognitive focus.

Key Features

Global code formatting and style violation correction
2 GitHub stars
Automated import statement updates and path management
Automated linting and diagnostic resolution across multiple files
Iterative verification using project-specific linters and tools
Bulk renaming of variables, functions, and classes codebase-wide

Use Cases

Resolving a large volume of ESLint or Prettier violations after a configuration change
Updating import paths across a project after moving directories or restructuring files
Renaming a core utility function used in dozens of files throughout the repository

About

Key Features

Global code formatting and style violation correction
2 GitHub stars
Automated import statement updates and path management
Automated linting and diagnostic resolution across multiple files
Iterative verification using project-specific linters and tools
Bulk renaming of variables, functions, and classes codebase-wide

Use Cases

Resolving a large volume of ESLint or Prettier violations after a configuration change
Updating import paths across a project after moving directories or restructuring files
Renaming a core utility function used in dozens of files throughout the repository