uv-script

Create and run standalone Python scripts with inline dependency metadata using uv.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

uv-script enables writing and running self-contained Python scripts that carry their own dependency metadata, eliminating the need for manual environment setup and global installations.

Core Features & Use Cases

  • Self-contained scripts with inline dependency metadata that declare requires-python and dependencies
  • Executable scripts without manual virtualenv management via shebang and uv
  • Reproducible environments with optional lock files for deterministic runs
  • Cross-machine portability and easy distribution for small utilities, automation tasks, and CLI tools

Quick Start

Create a small Python utility by adding an inline metadata header and run it with uv run --script to execute a self-contained program.

Frequently Asked Questions about uv-script

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

FAQPage Schema
How do I run a standalone Python script with its own dependencies without setting up a virtualenv?

You can run standalone Python scripts with inline dependency metadata using uv run --script. This executes self-contained programs directly without manual virtualenv management or global package installations.

What is inline metadata in Python scripts and how does it manage dependencies?

Inline metadata in Python scripts declares requires-python and dependencies directly in the file header. This mechanism allows uv to automatically resolve and manage dependencies for self-contained scripts.

Can I create executable Python scripts using uv that run across different machines?

Yes, uv supports creating executable Python scripts via shebang. These scripts offer cross-machine portability for small utilities and CLI tools without requiring manual environment setup on each machine.

How do I ensure reproducible environments for my Python automation scripts?

You can ensure reproducible environments for Python automation scripts by generating optional lock files with uv. These lock files provide deterministic dependency resolution for consistent runs across machines.

What is the best way to distribute small Python CLI tools without manual environment setup?

Distributing small Python CLI tools as self-contained scripts with uv is the best approach for avoiding manual environment setup. This method packages dependencies and execution logic together for easy distribution.