code-refactoring-assistant

Analyze Python and JS repositories to produce prioritized refactoring checklists and diffs.

3|Updated Oct 15, 2025
One-click install
npx skills add https://github.com/chaorenex1/coding-workflow --skill code-refactoring-assistant
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: code-refactoring-assistant
Source: https://github.com/chaorenex1/coding-workflow/tree/main/skills/code-refactoring-assistant
Command: npx skills add https://github.com/chaorenex1/coding-workflow --skill code-refactoring-assistant

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Codebases frequently require invasive changes that can inadvertently alter behavior. This skill analyzes a repository to surface refactoring opportunities by impact scope, enabling safer, more maintainable improvements.

Core Features & Use Cases

  • Impact Analysis: Assess refactor scope across files, dependencies, and tests to prioritize changes.
  • Checklist Generation: Produce structured, prioritized tasks grouped by impact with associated risks and benefits.
  • Interactive Review: Capture per-item approvals and feedback to control changes before execution.
  • Refactor Execution: Apply approved changes and generate git-ready diffs.
  • QA Validation: Run style, tests, coverage, and performance checks to validate changes.
  • Reporting: Produce before/after reports and metrics for decision-making.

Quick Start

Provide your repository codebase context and goals to generate a safe, prioritized refactor plan.

Frequently Asked Questions about code-refactoring-assistant

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

FAQPage Schema
How do I identify safe refactoring opportunities by analyzing impact scope?

Impact analysis assesses refactor scope across files, dependencies, and tests to prioritize changes safely. It produces a structured checklist with associated risks and benefits, enabling safer improvements before any code is actually modified.

What is the best way to generate a prioritized checklist for code refactoring?

The best way to generate a prioritized refactoring checklist is by analyzing your repository's impact scope. This produces structured tasks grouped by impact level, capturing per-item approvals and feedback to control changes before execution.

Can I execute targeted refactors and get git-ready diffs automatically?

Yes, you can execute targeted refactors and receive git-ready diffs automatically. After interactive review captures your per-item approvals, approved changes are applied directly and generated as diffs for immediate use in version control.

Does code refactoring work with Python and JS projects that have tests?

Yes, refactoring applies to typical software repositories containing Python and JS projects with tests and varying dependency graphs. It runs style, test, coverage, and performance checks to validate changes and produce before/after reports.

How do I validate code changes and run QA after a refactor?

To validate code changes after a refactor, run QA checks covering style, tests, coverage, and performance. This validates that approved changes maintain expected behavior and produces before/after reports with metrics for decision-making.

When should I not use automated refactoring on my codebase?

You should avoid automated refactoring when invasive changes risk altering behavior without comprehensive test coverage. It is designed for typical repositories with tests; lacking proper QA validation increases the risk of unintended side effects.