python-conventions

Enforce modern Python conventions with uv, ruff, and mypy.

Updated Feb 7, 2026
One-click install
npx skills add https://github.com/jsamuelsen11/claude-config --skill python-conventions-jsamuelsen11
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: python-conventions
Source: https://github.com/jsamuelsen11/claude-config/tree/main/plugins/ccfg-python/skills/python-conventions
Command: npx skills add https://github.com/jsamuelsen11/claude-config --skill python-conventions-jsamuelsen11

SYSTEM DOCUMENTATION & REQUIREMENTS

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.

Frequently Asked Questions about python-conventions

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I configure a Python project with uv, ruff, and mypy for modern type-safe code?

Configure a modern Python project by using uv as the universal package manager and project runner, ruff for linting and formatting, and mypy for type checking. This setup enforces type-safe conventions and maintainable code from the start.

What are modern Python conventions for type hints and structured data?

Modern Python conventions enforce PEP 604 unions, from __future__ annotations, and modern type hints for static typing. For structured data, these conventions favor using dataclasses or pydantic models to improve reliability and clarity.

Can I use uv to manage dependencies and run tests instead of standard Python tooling?

Yes, you can use uv as the universal package manager and project runner to manage dependencies, run tests, and validate builds. It replaces standard tooling to provide a unified workflow for modern Python projects.

What is the best way to enforce consistent Python formatting and linting?

The best way to enforce consistent Python formatting and linting is to use ruff for all related tasks. Applying ruff ensures consistent style and quality across the project while reducing boilerplate.

Why should I use ruff for Python linting instead of other category-level tools?

You should use ruff for Python linting because it provides standard toolchain integration alongside uv and mypy. It enforces consistent style and quality while reducing boilerplate compared to other category-level alternatives.