Refactoring Suggester
- 148 installs
- 2 repo stars
- Updated January 25, 2026
- jorgealves/agent_skills
Get agent-driven refactor recommendations while cleaning legacy modules, preparing PRs, or reducing complexity in active services without running a separate static-analysis toolchain.
About
Refactoring-suggester is an agent skill that inspects code structure and recommends targeted improvements such as method extraction, renaming, and simplification. It is aimed at teams maintaining SaaS, API, or CLI codebases who want automated, context-aware refactor ideas during iteration rather than one-off rewrites.
- Surfaces structural smells and rename/extract opportunities
- Proposes incremental, convention-aware refactors
- Supports PR review and maintenance workflows
- Reduces manual review time on repetitive cleanup
- Helps standardize patterns across modules
Refactoring Suggester by the numbers
- 148 all-time installs (skills.sh)
- +8 installs in the week ending Aug 2, 2026 (Skillselion tracking)
- Ranked #379 of 1,352 Code Review & Quality skills by installs in the Skillselion catalog
- Data as of Aug 2, 2026 (Skillselion catalog sync)
npx skills add https://github.com/jorgealves/agent_skills --skill refactoring-suggesterAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 148 |
|---|---|
| repo stars | ★ 2 |
| Last updated | January 25, 2026 |
| Repository | jorgealves/agent_skills ↗ |
What it does
Get agent-driven refactor recommendations while cleaning legacy modules, preparing PRs, or reducing complexity in active services without running a separate static-analysis toolchain.
Files
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.
name: refactoring-suggester
version: 1.0.0
description: 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.
inputs:
source_code:
type: string
required: true
target_pattern:
type: string
description: Optional pattern to move towards.
outputs:
refactor_plan:
type: array
items:
type: object
properties:
smell_detected:
type: string
suggested_action:
type: string
before_snippet:
type: string
after_snippet:
type: string
capabilities:
- Recognition of "God Objects" and "Long Methods."
- Automated snippet generation.
constraints:
- Requires manual verification of functional parity.
security:
- Operates locally.
examples:
- input:
source_code: "def log(m): print(m)"
output:
refactor_plan:
- smell_detected: "Primitive Obsession"
suggested_action: "Inject a logging interface"Related skills
Improve Codebase ArchitectureSafely deepen clusters of shallow modules into cohesive, testable units while respecting their external dependencies.566k196k
Caveman ReviewGet ultra-compressed, one-line code review comments that cut noise while keeping every actionable fix.270k94.7kCodebase DesignShared vocabulary for designing deep modules: improve a module's interface, find deepening opportunities, decide where a seam goes, make code more testable.266k196kCavecrewDelegate coding tasks to specialized subagents that return compressed output, keeping the main context window usable for much longer sessions.220k94.7kCode ReviewReviews a branch or PR diff on two axes at once: conformance to coding standards plus a code-smell baseline, and whether it actually implements the original spec.201k196k
Requesting Code ReviewDispatch a consistent, high-signal code reviewer subagent that catches plan deviations and quality issues before merging or continuing development.183k264k