refactor-suggestion

Analyze source code to identify actionable refactoring opportunities using Clean Code principles.

5|Updated Jan 31, 2026
One-click install
npx skills add https://github.com/onesyntax/skills --skill refactor-suggestion
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: refactor-suggestion
Source: https://github.com/onesyntax/skills/tree/main/skills/refactor-suggestion
Command: npx skills add https://github.com/onesyntax/skills --skill refactor-suggestion

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill analyzes code to identify actionable refactoring opportunities using Clean Code principles, helping teams reduce technical debt and improve maintainability.

Core Features & Use Cases

  • Identify Code Smells: Detect long methods, large classes, duplication, and other common issues.
  • Recommend Refactor Types: Classify the appropriate refactoring (Extract Method, Rename, Extract Class, etc.) and provide concrete guidance.
  • Guided Action Plan: Propose a safe, step-by-step plan aligned with Clean Code and testing strategies.

Quick Start

Provide the path to the codebase you're analyzing and request a refactor suggestion. The AI will return a prioritized list of refactor opportunities with concrete actions.

Frequently Asked Questions about refactor-suggestion

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

FAQPage Schema
How do I identify code smells and refactor opportunities in a legacy codebase?

To identify code smells in a legacy codebase, analyze source code to detect long methods, duplications, and tightly coupled components. The analysis returns a prioritized list of actionable refactoring opportunities targeting readability and maintainability improvements.

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

The best way to refactor messy code into clean code is applying a structured, step-by-step action plan. This involves classifying appropriate refactoring types like Extract Method or Rename, guided by Clean Code principles and testing strategies.

Can I get refactoring suggestions for large classes and long methods across multiple modules?

Yes, you can get refactoring suggestions for large classes and long methods across multiple modules. The analysis applies to evolving codebases and provides concrete guidance for extracting classes and functions to reduce technical debt.

Does clean code refactoring guidance include SOLID principles and naming conventions?

Yes, clean code refactoring guidance includes SOLID principles and naming conventions. It provides structured guidance across architecture, functions, and testing to comprehensively review and improve tightly coupled components.

How do I create a safe step-by-step plan for refactoring tightly coupled components?

Create a safe step-by-step plan for refactoring tightly coupled components by aligning the refactoring process with testing strategies. The plan classifies specific refactoring types and proposes concrete actions to ensure maintainability without breaking functionality.