# Refactoring Suggester

> Identifies code smells and provides step-by-step refactoring recipes. Use when improving legacy code maintainability or teaching students how to apply Clean Code and SOLID principles.

- Skill: `jorgealves/refactoring-suggester` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add jorgealves/refactoring-suggester`
- Raw SKILL.md: https://api.skillmd.com/api/skills/jorgealves/refactoring-suggester/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: jorgealves (https://skillmd.com/u/jorgealves)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/jorgealves/refactoring-suggester

---

# Refactoring Suggester

## Purpose and Intent
The `refactoring-suggester` teaches students and engineers how to evolve code. It doesn't just point out problems; it provides a recipe for how to fix them correctly.

## When to Use
- **Code Cleanup**: Use when a codebase has become difficult to manage or "messy."
- **Learning Exercises**: Show students how to transform their working code into "clean" code.

## When NOT to Use
- **Performance Optimization**: This tool focuses on *maintainability*, not necessarily on squeeze-every-cycle performance.

## Security and Data-Handling Considerations
- Operates locally on provided source code.