Agent_skills 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.

install

source · Clone the upstream repo

git clone https://github.com/jorgealves/agent_skills

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/jorgealves/agent_skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/refactoring-suggester" ~/.claude/skills/jorgealves-agent-skills-refactoring-suggester && rm -rf "$T"

manifest: refactoring-suggester/SKILL.md

source content

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.