python-project-toolchain

Automate Python project toolchain setup with uv, ruff, pyright, pytest, and pre-commit hooks.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/dragonkid/dotfiles --skill python-project-toolchain
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: python-project-toolchain
Source: https://github.com/dragonkid/dotfiles/tree/main/claude/skills/learned/python-project-toolchain
Command: npx skills add https://github.com/dragonkid/dotfiles --skill python-project-toolchain

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill standardizes and automates the setup of a robust Python project toolchain, reducing setup time and ensuring consistency across teams.

Core Features & Use Cases

  • Standard Toolchain: uv, ruff, pyright, pytest, and pre-commit hooks configured for modern Python development.
  • Audit & Upgrade: Quickly audit an existing project and upgrade legacy infrastructures to current best practices.
  • Onboarding: Provides a repeatable baseline to onboard new codebases and developers.

Quick Start

Use the command sequence below to initialize a new Python project with the standard toolchain and verify the setup: uv init project-name cd project-name uv pip install -e ".[dev]" pre-commit install make lint type-check test

Frequently Asked Questions about python-project-toolchain

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

FAQPage Schema
How do I set up a Python project toolchain with ruff, pyright, and pytest?

You can bootstrap a Python project toolchain by running uv init, installing dependencies, executing pre-commit install, and running make lint type-check test to verify your ruff, pyright, and pytest configurations.

Can I use this to upgrade legacy Python infrastructure to modern tooling?

Yes, this toolchain audits existing repositories and upgrades legacy Python infrastructure by integrating modern configurations for uv, ruff, pyright, and pre-commit hooks to align with current best practices.

What is the best way to configure pre-commit hooks for Python development?

Configuring pre-commit hooks within a standardized Python project toolchain alongside ruff, pyright, and pytest, managed through pyproject.toml, ensures consistent automated code quality checks before commits.

Does the toolchain configuration work with pyproject.toml and a Makefile?

Yes, the toolchain configuration integrates directly with pyproject.toml and includes a Makefile, allowing you to execute ruff, pyright, and pytest commands seamlessly via make lint type-check test.

Why do I need uv for Python project environment management?

You need uv to initialize projects and manage dependencies quickly, serving as the foundation for a Python project toolchain before installing development extras and configuring pre-commit hooks.

How do I automate linting and type-checking in a new Python project?

Automate linting and type-checking by installing ruff and pyright as development dependencies, configuring them in pyproject.toml, and executing checks through a provided Makefile or pre-commit hooks.