python-uv-workflow

Enforce uv-first execution, tests-before-refactor, and pre-commit quality gates for Python projects.

142|5|Updated Dec 26, 2015
One-click install
npx skills add https://github.com/shunk031/dotfiles --skill python-uv-workflow
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: python-uv-workflow
Source: https://github.com/shunk031/dotfiles/tree/main/home/dot_config/exact_agents/skills/python-uv-workflow
Command: npx skills add https://github.com/shunk031/dotfiles --skill python-uv-workflow

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Apply Python development policy using uv-first execution, test-first behavior validation, and pre-commit quality gates. Use when implementing or refactoring Python code.

Core Features & Use Cases

  • Enforce uv-first development for Python projects.
  • Promote test-first behavior validation and structured testing.
  • Streamline setup with pre-commit quality gates and Makefile guidance.
  • Provide refactoring guidance to preserve parity and update dependencies and tests.

Quick Start

Run your Python project with uv by default and verify changes by running tests and pre-commit checks.

Frequently Asked Questions about python-uv-workflow

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

FAQPage Schema
How do I enforce a uv-first Python workflow for my project?

A uv-first Python workflow requires executing scripts via uv run and automating pre-commit quality gates to govern development. This approach ensures consistent dependency management and validation during code implementation.

What is the best way to run Python tests before refactoring?

The best way to run Python tests before refactoring is to apply test-first behavior validation. This structured testing approach verifies existing behavior, ensuring you preserve parity when updating dependencies and modifying Python code.

How do I set up pre-commit and Makefile for a Python project?

Set up pre-commit and Makefile for a Python project by automating their configuration to streamline setup. This establishes quality gates that enforce uv-first execution and standardizes testing commands across common project layouts.

Can I use uv run for dependency management across different Python project layouts?

Yes, you can use uv run for dependency management across common Python project layouts. The workflow governs setup and guides dependency updates, ensuring uv manages execution consistently regardless of the specific project structure.

Does refactoring Python code with uv require updating tests?

Yes, refactoring Python code with uv requires updating tests to preserve behavioral parity. The workflow provides refactoring guidance that ensures test-first validation catches any regressions when you modify dependencies or restructure code.

Why do I need pre-commit quality gates in a uv-first development workflow?

You need pre-commit quality gates in a uv-first development workflow to automate code validation before changes are committed. This prevents regressions by enforcing structured testing and consistent execution standards across the Python project.