python-uv-setup

Set up Python projects with uv, ruff, and pytest.

12|Updated Feb 2, 2026
One-click install
npx skills add https://github.com/pratos/clanker-setup --skill python-uv-setup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: python-uv-setup
Source: https://github.com/pratos/clanker-setup/tree/main/skills/python-uv-setup
Command: npx skills add https://github.com/pratos/clanker-setup --skill python-uv-setup

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill streamlines the creation and migration of Python projects by leveraging uv, a fast, modern Python package installer and dependency manager, ensuring best practices for AI agent compatibility.

Core Features & Use Cases

  • Project Initialization: Quickly bootstrap new Python libraries or applications with a src layout, type hints, and pre-configured tooling (ruff, pytest, coverage).
  • Migration: Seamlessly migrate existing projects from requirements.txt, Poetry, Conda, or setup.py/setup.cfg to a uv-managed pyproject.toml setup.
  • Best Practices: Enforces strict version pinning, type hinting, and provides comprehensive CI/CD integration examples.

Quick Start

Use the python-uv-setup skill to create a new Python library named 'my-cool-package'.

Frequently Asked Questions about python-uv-setup

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

FAQPage Schema
How do I migrate an existing Python project from Poetry or requirements.txt to uv?

Migrating an existing Python project to uv involves converting dependency files like Poetry, Conda, or requirements.txt into a unified pyproject.toml configuration. This replaces older dependency managers with uv for faster package installation and modern environment management.

What is the best way to set up a new Python project with uv and a src layout?

The best way to set up a new Python project with uv is to bootstrap it using a src directory layout. This configuration includes type hints, strict version pinning, and pre-configured tooling like ruff for linting and pytest for testing out of the box.

Can I configure ruff and pytest together in a pyproject.toml file?

Yes, you can configure ruff for linting and formatting alongside pytest for testing within a single pyproject.toml file. Using uv to manage this setup ensures a unified configuration that enforces best practices across your Python project environment.

Does uv work with existing CI/CD pipelines for Python applications?

Yes, uv works with existing CI/CD pipelines by providing comprehensive integration examples for automated environments. Using uv for package management within your pipeline ensures strict version pinning and fast dependency resolution for your Python applications.

When do I need to migrate my Python project to a pyproject.toml configuration?

You need to migrate to a pyproject.toml configuration when transitioning from legacy setup.py or setup.cfg files to a modern standard. Using uv for this migration centralizes dependency management and aligns your project with current Python packaging best practices.