python-conventions

Enforce PEP 8 styling and linting with Ruff for Python 3.11+ codebases.

Updated Jan 15, 2026
One-click install
npx skills add https://github.com/rory-data/copilot --skill python-conventions-rory-data
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: python-conventions
Source: https://github.com/rory-data/copilot/tree/main/skills/python-conventions
Command: npx skills add https://github.com/rory-data/copilot --skill python-conventions-rory-data

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Python projects often suffer from inconsistent coding styles, unclear type hints, and outdated tooling. This skill standardizes Python development by outlining modern conventions and recommended tooling to improve readability and maintainability.

Core Features & Use Cases

  • Enforce PEP 8 styling and linting via Ruff for code quality and consistency.
  • Promote modern Python syntax (3.11+) and built-in type hints for clearer interfaces.
  • Recommend tooling and workflows with uv for dependency management and project setup.
  • Guide documentation, testing, and maintainable design practices for Python libraries and apps.
  • Use cases: when starting a new Python project, reviewing or refactoring existing code, or aligning teams on a common standard.

Quick Start

Apply the Python conventions to a new or existing project by configuring editors and tooling to follow PEP 8, Ruff, type hints, and 3.11+ features.

Frequently Asked Questions about python-conventions

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

FAQPage Schema
What is the best way to enforce modern Python conventions for a new project?

Ruff lints and formats Python code to enforce PEP 8 standards and modern syntax. It replaces multiple traditional linting tools to ensure consistent, readable, and reliable code across your project.

How do I set up a Python project using uv and Ruff?

Configure uv for package management and Ruff for linting to set up a Python project. This workflow enforces PEP 8 styling, manages dependencies, and ensures code quality for Python 3.11+ applications.

Can I use modern type hints with Python 3.11 and older versions?

Modern type hints using built-in annotations are designed for Python 3.11+ codebases. They promote clearer interfaces and reliable code, but may lack compatibility with older Python versions.

Does Ruff work with uv for Python dependency management?

Yes, Ruff works with uv to standardize Python development. Ruff handles PEP 8 linting and formatting while uv manages dependencies, together ensuring project maintainability and consistent code quality.

When should I refactor existing Python code to use modern conventions?

Refactor existing Python code to use modern conventions when aligning teams on a common standard or improving maintainability. This involves integrating Ruff, uv, and built-in type hints to update outdated tooling.