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.