python-refactor

What problem does it solve?

This Skill helps developers perform automated, safe Python refactorings by analyzing code with the AST and generating patch-friendly changes that preserve behavior and are easy to review.

Core Features & Use Cases

• AST-based refactor suggestions for common patterns and anti-patterns (e.g., unnecessary imports, formatting improvements, small function extractions).
• Patch/diff outputs that enable code review and deterministic application.
• Dry-run mode with backups and a safe apply workflow to verify changes before committing.
• Integration with unit tests to validate behavior after refactors.

Quick Start

Use the scripts/analyze.py to scan a Python project for refactor opportunities. Use the scripts/refactor.py to generate patches (dry-run by default). Use the scripts/apply_patch.py to apply confirmed patches safely (creates backups).