Why use UV scripts for Claude Code hooks?

They are ideal because they are self-contained and deterministic. You don't need to manage a global environment; the script handles its own requirements every time Claude executes it.

Can I use hyphens in my Python script names?

No, you should use underscores. Hyphens are interpreted as minus operators in Python, which prevents the script from being easily imported for unit testing.

How do I make a UV script executable?

Add the shebang #!/usr/bin/env -S uv run --script to the top of the file and run 'chmod +x' on the file to allow direct execution without the 'uv run' prefix.

A UV script is a single Python file that uses a PEP 723 metadata block to define its dependencies, allowing the UV tool to automatically create a temporary environment to run it.

Why must I include an empty dependencies list?

The PEP 723 specification requires the 'dependencies' field to be present even if it is empty; omitting it will cause UV to fail when trying to parse the script metadata.

UV Python Scripts

Name: UV Python Scripts
Author: racurry

byracurry

0•

Developer Tools

Standardizes the creation of self-contained Python scripts and Claude Code hooks using UV inline dependency metadata.

The uv-scripts skill provides a comprehensive framework for developing portable, single-file Python utilities leveraging PEP 723 inline metadata. By embedding dependencies directly within the script source, it enables automatic, isolated environment creation without the need for external requirements files or manual virtual environment setup. This skill is essential for developers building deterministic Claude Code hooks, standalone automation tools, and executable scripts that require consistent execution across different environments.

Key Features

01Optimized shebang patterns for direct script execution using 'uv run'

020 GitHub stars

03PEP 723 inline metadata implementation for self-contained dependency management

04Instructions for explicit script locking to ensure reproducible environments

05Standardized templates for Claude Code hook scripts with error handling

06Best practices for Python script naming and version requirements

Use Cases

01Building automated Claude Code hooks for linting, formatting, and validation

02Developing standalone DevOps scripts with pinned dependencies and specific Python versions

03Creating portable Python utilities that run instantly on any machine with UV

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add racurry/neat-little-package uv-scripts

For use in Claude.ai and ChatGPT

Download Skill