Agent skill · software engineering · aiskillstore
python-env
Fast Python environment management with uv (10-100x faster than pip). Triggers on: uv, venv, pip, pyproject, python environment, install package, dependencies.
Why this skill is useful
Adds specific commands and workflows for managing Python environments that the AI wouldn't reliably generate on its own.
What it needs
Requires uv installed locally. About 3k tokens when loaded. Last updated 2026-08-07. 405 stars on the source repository.
What this skill does
Python Environment Fast Python environment management with uv. Prefer the uv project workflow (uv add / uv sync / uv run) over the uv pip compatibility layer — it manages pyproject.toml + a lockfile for you and is reproducible. Quick Commands Task Command ------ --------- Start a project uv init <name> (app) · uv init --package <name> (installable, src/ layout) Add dependency uv add httpx Add dev dependency uv add --dev pytest ruff Remove dependency uv remove httpx Sync env from lockfile uv sync Run in project env uv run pytest Update lockfile uv lock Install a CLI tool uv tool install ruff · one-shot: uvx ruff Install a Python uv python install 3.12 Start a Project uv init creates pyproject.toml, pins a Python version, and prepares the project for uv add / uv sync. The --package (src) layout is preferred for anything with a test suite or that you intend to ship. Manage Dependencies uv creates and manages .venv automatically — you rarely activate it; just prefix commands with uv run. Run Code Never call bare python / pytest / ruff in a uv project — they may resolve to a different interpreter. Always uv run. CLI Tools (global, not project deps) Use uv tool / uvx for developer CLIs (ruff, pre-commit, httpie). Use uv add only for things your code imports. Python Versions Check python.org for the current stable (3.14 as of 2026-07; recent releases add opt-in free-threading and a JIT). 3.11+ is a sensible floor for new projects (TaskGroup, Self, faster interpreter). Minimal pyproject.toml Compatibility Layer (uv pip) — last resort uv pip mirrors pip's interface for environments uv doesn't manage (a hand-made venv, a legacy requirements.txt, CI that isn't uv-native). It does not update pyproject.toml or the lockfile — prefer uv add / uv sync whenever you control the project. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aiskillstore/python-env