clean-code-py

What problem does it solve?

This Skill helps turn hard-to-read Python into clearer, more maintainable code when a task calls for refactoring, naming cleanup, simpler function boundaries, or reduced accidental complexity.

Core Features & Use Cases

• Focused Python Refactoring: Improves readability without expanding scope into unnecessary style rewrites.
• Local Conventions First: Adapts to the project’s existing patterns for functions, data shapes, async flow, and error handling.
• Maintainability Reviews: Surfaces unclear names, mixed responsibilities, deep nesting, and unstable return contracts.
• Practical Example: Use it when a Python module is correct but difficult to scan, and you want a smaller, behavior-preserving refactor that makes future changes easier.

Quick Start

Apply the clean-code-py skill to the attached Python file and refactor it for clearer names, smaller responsibilities, and preserved behavior.