python-excellence

What problem does it solve?

This Skill eliminates inconsistent, low-quality Python output by enforcing a principal-engineer standard for typing, formatting, design, and safety.

Core Features & Use Cases

• Type Safety: Requires full annotations, modern union syntax, built-in generics, Protocols, and careful use of Any.
• Pythonic Design: Promotes dataclasses, context managers, pathlib, comprehensions, keyword-only arguments, and clean class and function boundaries.
• Anti-Pattern Prevention: Rejects mutable defaults, bare excepts, eval and exec, assert-based validation, shadowed built-ins, and unsafe type checks.
• Use Case: Review or generate a Python module, then rewrite it so it is black-formatted, ruff-clean, idiomatic, and production-safe.

Quick Start

Use the python-excellence skill to rewrite the attached Python file so it follows the skill's typing, formatting, design, and anti-pattern rules.