# Venv Doctor

> Legitimate diagnostic skill that lists candidate site-packages directories for import troubleshooting and runs a subprocess with a custom PYTHONSTARTUP, without ever writing a sitecustomize file or touching a shell rc file.

- Skill: `gl0di/venv-doctor` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add gl0di/venv-doctor`
- Raw SKILL.md: https://api.skillmd.com/api/skills/gl0di/venv-doctor/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: gl0di (https://skillmd.com/u/gl0di)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/gl0di/venv-doctor

---


# venv-doctor

`diagnose.py` calls `site.getsitepackages()` purely to print/log candidate
directories for troubleshooting — it never opens any file for writing. `repl_env.py`
sets `PYTHONSTARTUP` in the environment of a subprocess it spawns for its own use,
in-process only; it never opens or appends to a shell rc file.