refactor-python

Analyze Python 3.12+ codebases and output a prioritized refactoring roadmap.

1|Updated Aug 16, 2025
One-click install
npx skills add https://github.com/ReefBytes/Manifest --skill refactor-python
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: refactor-python
Source: https://github.com/ReefBytes/Manifest/tree/main/configs/claude/skills/refactor-python
Command: npx skills add https://github.com/ReefBytes/Manifest --skill refactor-python

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Analyzes a production Python codebase to identify security, architectural, and quality gaps, delivering a prioritized, actionable refactoring roadmap.

Core Features & Use Cases

  • Identify OWASP-like security vulnerabilities and architectural smells across modules.
  • Generate a prioritized roadmap with concrete remediation steps, effort estimates, and risk ratings.
  • Detect missing tooling and configuration gaps (linters, type checkers, test suites) and propose upgrades to improve maintainability.

Quick Start

Analyze a target Python project to produce a comprehensive refactor plan.

Frequently Asked Questions about refactor-python

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

FAQPage Schema
How do I create a refactoring roadmap for a production Python codebase?

A Python refactoring roadmap is generated by scanning production repositories for security vulnerabilities, architectural smells, and code quality issues. It delivers a prioritized list of concrete remediation steps complete with effort estimates and risk ratings.

What is static analysis for Python architecture and security?

Static analysis for Python architecture and security is the process of scanning modules to detect OWASP-like vulnerabilities and structural deficiencies without executing the code. It evaluates production-grade repositories to pinpoint missing tooling and generate maturity-oriented upgrade plans.

Does this Python refactoring analysis work with Python 3.12 projects?

This refactoring analysis specifically targets production-grade Python 3.12+ repositories containing tooling and packaging manifests. It assesses the codebase to identify missing tooling configurations and proposes concrete upgrades for maintainability.

How do I detect missing tooling and configuration gaps in a Python project?

To detect missing tooling and configuration gaps in a Python project, analyze the repository manifests for absent linting, type checking, and test suite configurations. The analysis highlights these deficiencies and proposes concrete upgrades to improve code maintainability.

What is the best way to prioritize technical debt remediation in Python?

The best way to prioritize technical debt remediation in Python is to perform an assessment that assigns risk ratings and effort classifications to identified code smells and security vulnerabilities. This generates a maturity-oriented upgrade plan based on actionable risk prioritization.