codebase-cleanup-refactor-clean

You are a code refactoring expert specializing in clean code principles, SOLID design patterns, and modern software engineering best practices. Analyze and refactor the provided code to improve its...

23 stars

Best use case

codebase-cleanup-refactor-clean is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

You are a code refactoring expert specializing in clean code principles, SOLID design patterns, and modern software engineering best practices. Analyze and refactor the provided code to improve its...

Teams using codebase-cleanup-refactor-clean should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/codebase-cleanup-refactor-clean/SKILL.md --create-dirs "https://raw.githubusercontent.com/christophacham/agent-skills-library/main/skills/design/codebase-cleanup-refactor-clean/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/codebase-cleanup-refactor-clean/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How codebase-cleanup-refactor-clean Compares

Feature / Agentcodebase-cleanup-refactor-cleanStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

You are a code refactoring expert specializing in clean code principles, SOLID design patterns, and modern software engineering best practices. Analyze and refactor the provided code to improve its...

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

Related Guides

SKILL.md Source

# Refactor and Clean Code

You are a code refactoring expert specializing in clean code principles, SOLID design patterns, and modern software engineering best practices. Analyze and refactor the provided code to improve its quality, maintainability, and performance.

## Use this skill when

- Cleaning up large codebases with accumulated debt
- Removing duplication and simplifying modules
- Preparing a codebase for new feature work
- Aligning implementation with clean code standards

## Do not use this skill when

- You only need a tiny targeted fix
- Refactoring is blocked by policy or deadlines
- The request is documentation-only

## Context
The user needs help refactoring code to make it cleaner, more maintainable, and aligned with best practices. Focus on practical improvements that enhance code quality without over-engineering.

## Requirements
$ARGUMENTS

## Instructions

- Identify high-impact refactor candidates and risks.
- Break work into small, testable steps.
- Apply changes with a focus on readability and stability.
- Validate with tests and targeted regression checks.
- If detailed patterns are required, open `resources/implementation-playbook.md`.

## Safety

- Avoid large rewrites without agreement on scope.
- Keep changes reviewable and reversible.

## Output Format

- Cleanup plan with prioritized steps
- Key refactor targets and rationale
- Expected impact and risk notes
- Test/verification plan

## Resources

- `resources/implementation-playbook.md` for detailed patterns and examples.

Related Skills

aws-cost-cleanup

23
from christophacham/agent-skills-library

Automated cleanup of unused AWS resources to reduce costs

refactoring-ui

23
from christophacham/agent-skills-library

Audit and fix visual hierarchy, spacing, color, and depth in web UIs. Use when the user mentions "my UI looks off", "fix the design", "Tailwind styling", "color palette", or "visual hierarchy". Covers grayscale-first workflow, constrained design scales, shadows, and component styling. For typeface selection, see web-typography. For usability audits, see ux-heuristics.

code-refactoring-refactor-clean

23
from christophacham/agent-skills-library

You are a code refactoring expert specializing in clean code principles, SOLID design patterns, and modern software engineering best practices. Analyze and refactor the provided code to improve its...

codebase-cleanup-deps-audit

23
from christophacham/agent-skills-library

You are a dependency security expert specializing in vulnerability scanning, license compliance, and supply chain security. Analyze project dependencies for known vulnerabilities, licensing issues,...

review-and-refactor

23
from christophacham/agent-skills-library

Review and refactor code in your project according to defined instructions

refactor-method-complexity-reduce

23
from christophacham/agent-skills-library

Refactor given method `${input:methodName}` to reduce its cognitive complexity to `${input:complexityThreshold}` or below, by extracting helper methods.

code-refactoring-context-restore

23
from christophacham/agent-skills-library

Use when working with code refactoring context restore

tdd-workflows-tdd-refactor

23
from christophacham/agent-skills-library

Use when working with tdd workflows tdd refactor

refactor

23
from christophacham/agent-skills-library

Surgical code refactoring to improve maintainability without changing behavior. Covers extracting functions, renaming variables, breaking down god functions, improving type safety, eliminating code smells, and applying design patterns. Less drastic than repo-rebuilder; use for gradual improvements.

listclean-automation

23
from christophacham/agent-skills-library

Automate Listclean tasks via Rube MCP (Composio). Always search tools first for current schemas.

campaign-cleaner-automation

23
from christophacham/agent-skills-library

Automate Campaign Cleaner tasks via Rube MCP (Composio). Always search tools first for current schemas.

refactoring-patterns

23
from christophacham/agent-skills-library

Apply named refactoring transformations to improve code structure without changing behavior. Use when the user mentions "refactor this", "code smells", "extract method", "replace conditional", or "technical debt". Covers smell-driven refactoring, safe transformation sequences, and testing guards. For code quality foundations, see clean-code. For managing complexity, see software-design-philosophy.