← ClaudeAtlas

env-doctor-freelisted

Diagnose local project environment issues that prevent apps from starting or running. Use when the user says "why won't this run", "check my environment", "env doctor", "diagnose startup issue", "it works on my machine", or asks for help debugging missing dependencies, runtime versions, port conflicts, .env problems, file permissions, or stopped services.
justhandledlabs/skills · ★ 0 · AI & Automation · score 73
Install: claude install-skill justhandledlabs/skills
# Env Doctor Diagnose the local environment before changing application code. Treat the project as innocent until the environment is ruled out. ## Workflow 1. Detect project type from files: - Node: `package.json` - Python: `requirements.txt`, `pyproject.toml`, `Pipfile`, or `manage.py` - Go: `go.mod` - Docker: `Dockerfile` or `docker-compose.yml` 2. Check runtime availability and versions: - Node: `node --version` and `npm --version` - Python: `python --version` or `python3 --version` - Go: `go version` - Docker: `docker --version` and `docker compose version` 3. Check dependencies: - Node projects with no `node_modules/`: flag as high priority and suggest `npm install`. - Python projects with no `.venv/`, `venv/`, or active virtual environment: flag and suggest creating one, then installing requirements. - Go projects: run `go mod tidy` only after explaining it mutates `go.mod`/`go.sum`; otherwise suggest it as the fix. - Docker projects: check whether Docker is running before suggesting rebuilds. 4. Check common port conflicts for `3000`, `3001`, `5000`, `8000`, and `8080`. - Detect the operating system before providing commands. - On macOS/Linux, inspect listeners with `lsof -nP -iTCP:<port> -sTCP:LISTEN`, then identify the PID with `ps`. - On Windows PowerShell, inspect listeners with `Get-NetTCPConnection -LocalPort <port>`, then identify the owning PID with `Get-Process`. - Report the PID, executable or service name, a