Does this skill help with script permissions?

Yes, it provides the correct shebang line (#!/usr/bin/env -S uv run --script) which, combined with chmod +x, makes the Python script act like a standalone executable.

PEP 723 is a Python standard that allows you to specify a script's dependencies and required Python version directly within the script file itself using a special comment block.

When should I use inline metadata instead of a pyproject.toml?

Use inline metadata for standalone scripts, maintenance tasks, or CI/CD utilities that don't need to be part of a larger project's core dependency list.

How does this skill work with the uv package manager?

This skill formats scripts so that the 'uv' tool can read the inline metadata, automatically create a temporary environment with the necessary packages, and execute the script in one command.

Python uv & PEP 723 Scripting

Name: Python uv & PEP 723 Scripting
Author: pokutuna

bypokutuna

•

Developer Tools

Generates self-contained Python scripts with inline dependency metadata using the uv package manager and PEP 723 standards.

The uv-pep723 skill empowers developers to create portable, single-file Python scripts by automating the inclusion of PEP 723 inline metadata. This skill ensures your scripts are immediately executable via 'uv run' by defining dependencies directly within the script file, eliminating the need for a separate pyproject.toml for utility or throwaway scripts. It provides standardized patterns for shebangs and script blocks, making local workflows, CI/CD tasks, and debugging efforts more efficient and maintainable.

Key Features

01Optimizes scripts for portability and immediate execution

02Automatically generates PEP 723 inline script metadata blocks

031 GitHub stars

04Manages script-specific dependencies without polluting project configuration

05Configures executable shebangs for 'uv run --script' compatibility

06Provides best practices for self-contained Python utility development

Use Cases

01Developing self-contained Python tools that run without a full project environment

02Writing throwaway debugging scripts with external dependencies

03Creating portable CI/CD or deployment utility scripts

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add pokutuna/claude-plugins uv-pep723

For use in Claude.ai and ChatGPT

Download Skill