python-conventions

What problem does it solve?

This skill provides a comprehensive set of Python conventions and tooling expectations to ensure projects are built with modern, type-safe, and maintainable practices, reducing boilerplate and onboarding time.

Core Features & Use Cases

• Standard Toolchain: uv as the universal package manager and project runner to manage dependencies, run tests, and validate builds.
• Linting and Formatting: Use ruff for all linting and formatting tasks to enforce consistent style and quality.
• Static Typing and Modern Syntax: Enforce modern type hints, from future annotations, and PEP 604 unions, with mypy for type checking.
• Structured Data and Testing: Favor dataclasses/pydantic models and robust testing patterns to improve reliability and clarity.
• Project Organization and Governance: Provide a blueprint for structuring projects and avoiding common anti-patterns.

Quick Start

Apply these conventions to a Python project to align tooling, formatting, type checking, and modern syntax from the start.