review-and-refactor

Identify code smells and generate a step-by-step refactor plan.

1|Updated Apr 7, 2026
One-click install
npx skills add https://github.com/han-so1omon/ikam --skill review-and-refactor-han-so1omon
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: review-and-refactor
Source: https://github.com/han-so1omon/ikam/tree/main/skills/review-and-refactor
Command: npx skills add https://github.com/han-so1omon/ikam --skill review-and-refactor-han-so1omon

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps engineers systematically identify code issues and plan safe refactors to improve maintainability without changing external behavior.

Core Features & Use Cases

  • Guided code review: collects guidelines and checks to surface code smells and anti-patterns.
  • Non-destructive refactoring: proposes changes that preserve functionality and document rationale.
  • Testing and documentation alignment: ensures tests pass and changes are documented.

Quick Start

Identify code smells in the current project and generate a safe, step-by-step refactor plan that preserves behavior.

Frequently Asked Questions about review-and-refactor

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

FAQPage Schema
How do I refactor a codebase to improve maintainability without breaking existing functionality?

To refactor a codebase safely, you need a non-destructive approach that identifies code smells, proposes changes preserving external behavior, and ensures tests pass. This process focuses on cleanup and alignment with established guidelines while documenting the rationale for each modification.

What is the best way to plan a safe code refactor for a long-lived project?

The best way to plan a safe code refactor is using a guided review process that collects established checks to surface anti-patterns. This generates a step-by-step plan ensuring deterministic, non-destructive changes with test preservation.

Does refactoring code affect my existing tests?

Proper refactoring should not break existing tests. The process requires non-destructive changes that explicitly preserve functionality and maintain testing alignment, ensuring all tests continue to pass after the code quality improvements are applied.

How do I identify code smells and anti-patterns in my current software project?

You can identify code smells by applying a guided code review mechanism that collects established guidelines and checks against your codebase. This systematically surfaces maintainability issues and anti-patterns for targeted cleanup.

Can I use automated refactoring on long-lived codebases?

Yes, automated refactoring is highly applicable to long-lived codebases. It systematically targets code quality issues by proposing deterministic changes that clean up the architecture while strictly preserving the software's external behavior.