python-code-style

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.