skills.rest
jorgealves
jorgealvesCOMMUNITY
Explore all skills by this author →
Website𝕏@JorgeAndreAlvesGitHub

refactoring-suggester

Detect code smells and generate refactoring recipes with before and after snippets.

2|1|Updated Jan 25, 2026
Search Tags:#maintainability#refactor#clean-code#code-smells#legacy-code#solid-principles
One-click install
npx skills add https://github.com/jorgealves/agent_skills --skill refactoring-suggester
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: refactoring-suggester
Source: https://github.com/jorgealves/agent_skills/tree/main/refactoring-suggester
Command: npx skills add https://github.com/jorgealves/agent_skills --skill refactoring-suggester

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill identifies code smells in a codebase and provides step-by-step refactoring recipes. It helps improve maintainability, readability, and adherence to Clean Code and SOLID principles.

Core Features & Use Cases

  • Detects common smells such as God Objects and Long Methods in existing codebases.
  • Generates actionable refactoring recipes with before_snippet and after_snippet, facilitating learning and practical improvements.
  • Suitable for legacy code maintenance and educational environments to demonstrate SOLID-driven transformations.

Quick Start

Apply the refactoring-suggester to your legacy project to generate a structured refactor_plan. Provide the target source code file or snippet to analyze, then review the resulting plan and manually verify functional parity.

Frequently Asked Questions about refactoring-suggester

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I identify code smells in a legacy codebase?▼

To identify code smells in a legacy codebase, provide local source code for analysis. The system detects issues like God Objects and Long Methods, outputting a structured refactor plan to improve maintainability and adherence to SOLID principles.

What is the best way to refactor messy code into clean code?▼

The best way to refactor messy code into clean code is by generating step-by-step refactoring recipes. These recipes include before and after snippets to demonstrate SOLID-driven transformations and improve overall readability.

Can I use refactoring recipes to teach SOLID principles?▼

Yes, you can use refactoring recipes to teach SOLID principles in educational environments. The generated before and after snippets demonstrate practical transformations from legacy code to maintainable, clean code structures.

Does applying a refactor plan automatically guarantee functional parity?▼

No, applying a refactor plan does not automatically guarantee functional parity. After implementing the suggested refactoring recipes, you must manually verify that the original functionality remains completely intact.

How do I generate a refactoring plan for a specific source code file?▼

To generate a refactoring plan for a specific source code file, provide the target file or snippet for analysis. The system consumes the local input and outputs a structured plan with actionable refactoring steps.

Related Skills

Explore More Software Engineering Skills→
fubirafubira
1

refactoring-assistant

Detect code smells and propose refactoring patterns for Go and TypeScript/React projects.

Community
Advanced
MinhThang1009MinhThang1009
15

refactor

Plan, execute, and verify atomic code refactors with test-backed steps.

Community
Intermediate
nguyenphpnguyenphp
41

lint-and-validate

Run linters, type checkers, and security audits across Node.js and Python projects.

Community
Intermediate
dsivovdsivov

clean-code-practices

Enforce KISS, DRY, and YAGNI standards during software development tasks.

Community
Intermediate