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

개발자 도구

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.

주요 기능

Optimized shebang patterns for direct script execution using 'uv run'
0 GitHub stars
PEP 723 inline metadata implementation for self-contained dependency management
Instructions for explicit script locking to ensure reproducible environments
Standardized templates for Claude Code hook scripts with error handling
Best practices for Python script naming and version requirements

사용 사례

Building automated Claude Code hooks for linting, formatting, and validation
Developing standalone DevOps scripts with pinned dependencies and specific Python versions
Creating portable Python utilities that run instantly on any machine with UV

소개

주요 기능

Optimized shebang patterns for direct script execution using 'uv run'
0 GitHub stars
PEP 723 inline metadata implementation for self-contained dependency management
Instructions for explicit script locking to ensure reproducible environments
Standardized templates for Claude Code hook scripts with error handling
Best practices for Python script naming and version requirements

사용 사례

Building automated Claude Code hooks for linting, formatting, and validation
Developing standalone DevOps scripts with pinned dependencies and specific Python versions
Creating portable Python utilities that run instantly on any machine with UV