separate-monolithic-python

What problem does it solve?

Overly large, monolithic Python files (e.g., >500 Lines of Code) become difficult to read, maintain, and test, leading to increased development time and higher bug potential. This skill automates the process of breaking them into smaller, well-organized modules, improving code quality and developer productivity.

Core Features & Use Cases

• Automated Code Analysis: Intelligently analyzes the monolithic file to identify logical components, map dependencies, and plan optimal module structures (by responsibility, feature, or layer).
• Structured Code Extraction: Systematically extracts code into new modules, ensuring proper package structure, __init__.py exports, and adherence to Python best practices.
• Intelligent Import Management: Automatically updates all internal and external import statements to reflect the new module structure, including smart handling of circular dependencies to prevent runtime errors.
• Use Case: You have a main.py file that has grown to 1000 lines, containing models, services, and API routes. This skill can refactor it into models.py, services.py, and routes.py within a new package, updating all imports and ensuring the code remains functional and maintainable.

Quick Start

Before (monolith.py - 800 lines):

DATABASE_URL = "sqlite:///./test.db"

class User: ...

def create_user(name): ...

app = FastAPI()

@app.get("/users") ...

After (structured package):

api/

├── init.py

├── config.py # DATABASE_URL

├── models.py # User class

├── services.py # create_user

└── routes.py # FastAPI routes