programming-python

What problem does it solve?

This Skill helps you avoid fragile Python codebases by guiding you to use type-driven design, clean architecture, and reliable project structure instead of ad-hoc scripts and mutable global state.

Core Features & Use Cases

• Type-driven design: enforce public interfaces with type annotations, dataclasses, Pydantic v2 models, TypedDict, Protocols, and explicit optionals to reduce runtime surprises.
• Maintainable architecture: structure modules by data flow and boundaries, keep side effects at the edge, and define the public API via init.py and all.
• Production-ready patterns: choose a single concurrency model, handle errors with specific exceptions and context, default to the standard library first, and use ecosystem defaults like uv, httpx, FastAPI, pytest, and hypothesis.

Quick Start

Ask for a plan to refactor an existing Python project into a typed, testable architecture that follows src layout, isolates side effects, and uses a consistent async strategy, starting from the current module structure and data models.