What problem does it solve?
Python codebases often drift into inconsistent layouts, making maintenance harder. This Skill provides a cohesive set of conventions for organizing service classes and modules, ensuring readable APIs, reliable datetimes, and safe imports.
Core Features & Use Cases
- Standard Method Organization: enforce the recommended order (special methods, class/static methods, public, private) to improve readability and onboarding.
- Timezone-Aware Datetimes: promote timezone-aware datetimes and eliminate naive timestamps across the codebase.
- Circular Import Avoidance: guide refactors to remove one-way dependencies and reduce import-time issues.
- Modern Type Annotations: encourage typing techniques like Self, future annotations, and clean type hints in interfaces and dataclasses.
- Module-Level Organization: apply structured module patterns for dataclasses, public APIs, and utilities.
Quick Start
Start by inspecting a Python module and reorganize its class and functions to follow the recommended method ordering, convert naive datetimes to timezone-aware ones, and remove circular imports.
