uv-global

Manage a global uv Python environment for ad hoc script execution.

Updated Feb 1, 2026
One-click install
npx skills add https://github.com/guoqiao/skills --skill uv-global
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: uv-global
Source: https://github.com/guoqiao/skills/tree/main/uv-global/uv-global
Command: npx skills add https://github.com/guoqiao/skills --skill uv-global

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill provides a centralized, reusable Python environment for running quick, ad hoc scripts without cluttering your system or project-specific virtual environments.

Core Features & Use Cases

  • Global Environment Management: Installs and manages a single uv environment at ~/.uv-global.
  • Dependency Installation: Easily add Python packages to the global environment for use in any script.
  • Script Execution: Run Python scripts using the global environment and its installed packages.
  • Use Case: You need to quickly process a CSV file with pandas and loguru for logging. Instead of creating a new virtual environment, you use this Skill to add pandas and loguru to the global environment and run your script.

Quick Start

Add the 'requests' package to the global uv environment and then run the script 'my_script.py' using it.

Frequently Asked Questions about uv-global

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

FAQPage Schema
How do I run ad hoc Python scripts with dependencies like pandas without creating a new virtual environment?

You can run ad hoc Python scripts with dependencies by provisioning a global uv Python environment. This Skill installs packages like pandas into a centralized environment at ~/.uv-global, allowing you to execute scripts directly without managing project-specific virtual environments.

What is the best way to manage a global Python environment for quick utility scripting?

The best way to manage a global Python environment for utility scripting is using a centralized uv environment. This approach installs and manages a single uv environment for ad hoc script execution, preventing system clutter while facilitating common tasks like data processing and web scraping.

Do I need uv installed to use a global Python environment for scripting?

Yes, you need uv installed to use this global Python environment. The Skill requires uv to be present on your system, but it includes a fallback mechanism to automatically install uv via brew or curl if it is not already available.

How do I add Python packages to a global uv environment for data processing?

To add Python packages for data processing, the Skill facilitates dependency installation directly into the global uv environment. Once added, these packages are available for use in any ad hoc script executed through this centralized environment.

Can I use this global uv environment for web scraping tasks?

Yes, you can use this global uv environment for web scraping tasks. The Skill is designed to facilitate the installation of common Python packages, allowing you to easily add scraping libraries to the global environment and run your utility scripts.

When should I not use a global Python environment for my scripts?

You should avoid using a global Python environment when your scripts require isolated, project-specific dependencies. This centralized approach is intended for quick, ad hoc script execution and may cause dependency conflicts if used for complex projects with strict version requirements.