What is the purpose of the CLEANUP.md file?

The CLEANUP.md file acts as a blueprint where the skill records its findings, rates task complexity, and groups issues into batches for your review before any code is actually modified.

Which programming languages are supported?

While it includes specialized logic for JavaScript (knip) and Elixir (credo), the agent-based approach is designed to follow idiomatic guidelines for any language provided in the codebase.

Can it handle large repositories efficiently?

Yes, for large codebases, the skill spawns multiple language expert agents in parallel to handle individual folders or large files simultaneously, significantly speeding up the refactoring process.

How does the skill ensure it doesn't break my code?

The skill follows a strict safety process: it runs your existing test suite before and after changes, creates a CLEANUP.md plan for your approval, and allows you to ignore specific failing tests if needed.

Code Cleanup & Refactoring

Name: Code Cleanup & Refactoring
Author: nocksock

bynocksock

•

開発者ツール

Automates the identification and resolution of code smells, linting warnings, and architectural inconsistencies across large codebases.

The Code Cleanup skill streamlines technical debt management by integrating industry-standard linting tools like knip for JavaScript and Credo for Elixir into an automated workflow. It systematically analyzes project health, generates a detailed CLEANUP.md strategy for user approval, and orchestrates parallel AI agents to execute refactoring tasks without breaking the existing test suite. This skill is essential for maintaining code quality after implementing large features or when onboarding onto legacy projects that require standardized patterns.

主な機能

01Automated linting and static analysis integration (JS/Elixir)

021 GitHub stars

03Generates a transparent CLEANUP.md execution plan

04Hierarchical task grouping by complexity and pattern type

05Test-aware refactoring with pre-and-post validation

06Parallel agent orchestration for large-scale file processing

ユースケース

01Standardizing patterns after a major feature rollout or architectural shift

02Preparing a repository for production by resolving all compiler and static analysis warnings

03Reducing technical debt in legacy codebases through automated linting fixes

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add nocksock/superpowers code-cleanup

For use in Claude.ai and ChatGPT