python-tooling

Select and configure Python tooling for environments, packaging, linting, typing, testing, and CI.

1|Updated Apr 15, 2026
One-click install
npx skills add https://github.com/pnewsam/skills --skill python-tooling-pnewsam
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: python-tooling
Source: https://github.com/pnewsam/skills/tree/main/archive/python-evicted/python-tooling
Command: npx skills add https://github.com/pnewsam/skills --skill python-tooling-pnewsam

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Choosing and migrating Python project tooling is error-prone: teams accumulate competing lockfiles, mismatched linters, and divergent local versus CI behavior. This Skill guides selection, configuration, and migration of Python toolchains while preserving working repository conventions. ## Core Features & Use Cases - Toolchain Selection: Recommends coherent stacks for environments and dependencies (uv, Poetry, pip-tools), packaging backends, linting and formatting (Ruff), type checking (Mypy, Pyright), and testing (pytest). - New-Project Baseline: Provides a concrete greenfield starting point with uv, Ruff, strict type checking, pytest with coverage floors, pre-commit, and PEP 621 metadata in pyproject.toml. - Migration Workflow: Defines an eight-step migration process that records current behavior, verifies candidates against official documentation, and removes obsolete configuration only after the new path is proven. - Use Case: When inheriting a repository with both Poetry and pip-tools lockfiles, use this Skill to identify the authoritative dependency source, plan a staged migration to a single lockfile, and verify local and CI builds stay reproducible. ## Quick Start Use the python-tooling skill to review this repository's pyproject.toml and CI configuration and recommend a coherent toolchain with a migration plan.

Frequently Asked Questions about python-tooling

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

FAQPage Schema
How do I choose Python tooling for a new project?▼

Start with uv for environments and dependencies with a committed uv.lock, Ruff for linting and formatting, Mypy or Pyright in strict mode on new code, pytest with branch coverage, pre-commit hooks, and PEP 621 metadata in pyproject.toml. Verify current official documentation before adopting any tool.

Should I use uv or Poetry for Python dependency management?▼

uv is a strong default for new projects when it supports your index, platform, build, and deployment needs. Existing Poetry, PDM, or pip-tools workflows may be entirely reasonable; migrate only with a concrete benefit, an adoption plan, and verified reproducible builds.

Mypy vs Pyright: which Python type checker should I use?▼

Both are production-ready. Pyright drives most editor tooling, while Mypy has the widest plugin ecosystem. Choose the checker already supported by your codebase and editor workflow, and never run two checkers with divergent configurations.

How do I migrate Python packaging tools without breaking CI?▼

Record current setup, lock, checks, and release behavior first. Introduce the new configuration without changing application behavior, compare resolved dependencies and build artifacts, run the full test and packaging matrix, and remove old configuration only after the new path is proven.

When should I not migrate a Python project's toolchain?▼

Do not churn a functioning project merely to standardize names or follow trends. A migration needs a concrete measurable benefit, and you should avoid combining dependency upgrades, repository-wide formatting, and build backend changes in one migration.