Will it modify my library modules?

The skill includes logic to identify non-executable library modules and ensures they do not have unnecessary shebangs, following Python best practices.

Can this skill fix file permission issues?

Yes, it specifically checks if the execute bit is set for any file containing a shebang and provides the necessary commands to fix it if it's missing.

What is PEP 723 and how does this skill help?

PEP 723 is a standard for specifying external dependencies directly within a single-file script. This skill automatically adds or validates these blocks so your scripts run anywhere with the right packages.

Why does this skill use the 'uv' command in shebangs?

The 'uv' tool is an extremely fast Python package manager. Using it in a shebang allows a script to automatically manage its own virtual environment and dependencies upon execution.

Python Shebang & PEP 723 Validator

Name: Python Shebang & PEP 723 Validator
Author: Jamie-BitFlight

byJamie-BitFlight

•

Developer Tools

Ensures Python scripts follow correct shebang patterns and PEP 723 inline metadata standards for seamless execution and dependency management.

The Python Shebang & PEP 723 Validator is a specialized Claude Code skill designed to automate the management of script execution headers and metadata. It intelligently identifies whether a Python file is a standalone script, a library module, or part of a larger package, then applies the appropriate shebang—including advanced 'uv' patterns for scripts with external dependencies. By validating imports against PEP 723 requirements and ensuring the execute bit is set, this tool eliminates common 'command not found' or 'missing dependency' errors, making Python scripts more portable and robust.

Key Features

01Full support for PEP 723 inline script metadata declaration

02Automatic shebang validation and correction based on script context

03Intelligent import analysis to differentiate between stdlib and external packages

04Optimized integration with 'uv' for standalone dependency management

0518 GitHub stars

06Automatic execute bit (chmod +x) verification and enforcement

Use Cases

01Adding PEP 723 metadata to existing scripts to simplify distribution and execution

02Converting standard Python scripts into standalone tools with uv-managed dependencies

03Auditing repositories to ensure executable scripts have proper permissions and headers

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jamie-bitflight/claude_skills shebangpython

For use in Claude.ai and ChatGPT

Download Skill