update-venv-pythonlisted
Install: claude install-skill rrokot/python-updater-skill
# Update Python (Python Install Manager + venv)
Installs the latest official Python on Windows via the Python Install Manager,
makes it the OS default, and rebuilds the project's uv/poetry venv on it.
## Usage
Run it **from the project directory**. `scripts/update_python.ps1` is the entry
point — do not invoke `scripts/update_python.py` directly, it is only the second
half and installs nothing. Below, `<skill>` is this skill's directory.
```powershell
& "<skill>\scripts\update_python.ps1" # current directory
& "<skill>\scripts\update_python.ps1" -p ..\service # another project
```
`-p` / `-Project` is the only option. The rest is automatic: venv manager
auto-detected (uv or poetry) and upgraded, stable releases only, OS default
updated, install manager updated, legacy launcher removed.
## Guidance for the agent
- Changes apply immediately and there is no dry-run mode. **Confirm with the user
before running** — a real run changes the OS default Python and also upgrades
the project's uv or poetry to the latest version.
- If it exits 1 with a list of PIDs, those processes hold the install being
replaced. Relay the list and ask the user to close them; do not kill them
yourself. Then re-run — the script is idempotent.
- That list can be incomplete (elevated processes, other bitness). If the install
still fails with `files are still in use`, closing the IDE and any terminals is
the practical next step.
- Rebuilding the venv can fail on a locke