uv-python-execution

Execute Python scripts with uv run and type check with ty check.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill ensures all Python script executions and type checking operations are performed using the modern, fast uv and ty toolchain, promoting consistency, speed, and dependency isolation.

Core Features & Use Cases

  • Python Execution: Replaces direct python or python3 commands with uv run for script and module execution, leveraging project virtual environments.
  • Type Checking: Enforces the use of ty check for all static type analysis, offering a faster and more integrated experience than pyright or mypy.
  • Inline Scripts (PEP 723): Supports running standalone Python scripts with their own specified dependencies using uv run --script.
  • Use Case: When asked to "run a Python script to process data", the skill will automatically use uv run python process_data.py, ensuring it uses the correct environment and dependencies. When asked to "type check the codebase", it will execute ty check.

Quick Start

Execute the python script 'analyze_logs.py' using uv.

Frequently Asked Questions about uv-python-execution

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

FAQPage Schema
How do I execute Python scripts with inline dependencies using PEP 723?

To execute Python scripts with inline dependencies, this Skill enforces using `uv run --script` to process PEP 723 metadata, ensuring the specified dependencies are resolved and run in an isolated environment.

What is the best way to run a Python script in an isolated virtual environment?

The best way to run a Python script in an isolated virtual environment is by using `uv run`, which this Skill substitutes for direct Python commands to leverage project environments automatically.

How does type checking work with ty compared to other Python static analysis tools?

Type checking with `ty check` replaces traditional tools like mypy or pyright to offer a faster, integrated static type analysis experience directly within the modern Python toolchain.

Can I use uv run to execute Python modules instead of calling python directly?

Yes, you can use `uv run` to execute Python modules, as this Skill replaces direct `python` or `python3` commands to ensure consistent execution within the correct project virtual environment.

Does uv run support standalone scripts that specify their own dependencies?

Yes, `uv run` supports standalone scripts specifying their own dependencies via PEP 723 inline script metadata, allowing you to execute them with `uv run --script` for proper dependency isolation.

Why should I use uv run instead of python for executing data processing scripts?

You should use `uv run` instead of `python` because it optimizes Python development workflows by ensuring fast, consistent execution within the correct isolated project environment and dependencies.