refactor-analyzer

Analyzes Python codebases to identify refactoring opportunities and plan extractions.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/ribatshepo/cc-auto-orchestrate --skill refactor-analyzer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: refactor-analyzer
Source: https://github.com/ribatshepo/cc-auto-orchestrate/tree/main/claude-code/skills/refactor-analyzer
Command: npx skills add https://github.com/ribatshepo/cc-auto-orchestrate --skill refactor-analyzer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Interactive refactoring planning and analysis to improve code structure and maintainability by identifying candidates and organizing extractions.

Core Features & Use Cases

  • Code structure analysis: computes function groups, dependencies, and complexity metrics to identify refactoring candidates.
  • Refactor planning: generates extraction plans detailing target modules, required dependencies, and integration points with the refactor-executor skill.
  • Safe execution guidance: enforces rules to avoid circular dependencies and preserve functionality, with traceable change plans.
  • Use Case: apply to a multi-module project to restructure sprawling modules into cohesive units with clearer interfaces.

Quick Start

Provide a target Python codebase to analyze and receive a prioritized refactor plan.

Frequently Asked Questions about refactor-analyzer

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

FAQPage Schema
How do I identify refactoring opportunities in a Python codebase?

This skill analyzes Python codebases by computing function groups, dependencies, and complexity metrics to pinpoint extraction candidates and plan cohesive modular restructuring.

What is the best way to plan safe code extractions for modular Python projects?

Planning safe code extractions involves generating stepwise plans that enforce dependency rules, prevent circular imports, and define clear success criteria for modular Python projects.

How do I avoid circular dependencies when refactoring sprawling Python modules?

You avoid circular dependencies when refactoring sprawling Python modules by applying enforced extraction rules and dependency checks that ensure safe, cohesive restructuring with traceable change plans.

Does this refactoring analysis tool work with automated refactor executors?

Yes, this refactoring analysis tool works with automated refactor executors by generating extraction plans that detail target modules, required dependencies, and integration points for safe automated execution.

What are the limitations of analyzing code complexity for Python refactoring?

The limitations of analyzing code complexity for Python refactoring include its restriction to modular Python projects, meaning it may not suit non-modular or monolithic codebases lacking clear module boundaries.