bootstrap-uv-python-workspace

Scaffold uv Python workspaces with pytest, ruff, and mypy tooling.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/gaelic-ghost/python-skills --skill bootstrap-uv-python-workspace
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bootstrap-uv-python-workspace
Source: https://github.com/gaelic-ghost/python-skills/tree/main/bootstrap-uv-python-workspace
Command: npx skills add https://github.com/gaelic-ghost/python-skills --skill bootstrap-uv-python-workspace

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires uv, git, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

Bootstrap uv Python workspaces and multi-package projects with deterministic scaffolding to standardize setup across teams.

Core Features & Use Cases

  • Scaffolds single-project and multi-package uv Python workspaces with package/service profiles.
  • Initializes dev tooling (pytest, ruff, mypy) and generates README scaffolds.
  • Supports layered YAML customization for Python version, profiles, and git init.

Quick Start

Run scripts/init_uv_python_workspace.sh --name my-workspace to scaffold a new uv Python workspace.

Frequently Asked Questions about bootstrap-uv-python-workspace

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

FAQPage Schema
How do I scaffold a uv Python workspace with multiple packages?▼

To scaffold a uv Python workspace with multiple packages, run scripts/init_uv_python_workspace.sh --name my-workspace. It generates single-project and multi-package layouts with package/service profiles, layered YAML customization, and initializes pytest, ruff, and mypy tooling.

What is a uv Python workspace and when do I need one?▼

A uv Python workspace standardizes Python development across teams by providing deterministic scaffolding for single-project and multi-package layouts. You need one to ensure consistent setup, tooling initialization, and package profiles across your development environment.

Do I need git installed to bootstrap a uv Python project?▼

Git is an optional dependency for bootstrapping a uv Python project. The Skill enforces required prerequisites such as uv, but git initialization is optional and can render ready-to-use scaffolds with an optional initial commit if enabled.

Can I customize the Python version when creating a uv workspace?▼

You can customize the Python version when creating a uv workspace through layered YAML customization. This configuration also supports specifying package/service profiles and enabling optional git initialization during the scaffolding process.

What dev tooling does a scaffolded uv Python project include?▼

A scaffolded uv Python project includes built-in dev tooling initialization for pytest, ruff, and mypy. It also generates README scaffolds and validates target directories before rendering the ready-to-use workspace layout.

What's the best way to standardize Python project setup across a team?▼

The best way to standardize Python project setup across a team is using deterministic uv-based scaffolding. It creates consistent project and workspace structures with package/service profiles, YAML customization, and unified tooling initialization to eliminate configuration drift.