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.
---
name: env-doctor-free
description: 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.
license: MIT
metadata:
version: 1.3.0
author: JustHandled Labs
triggers:
- why won't this run
- check my environment
- env doctor
- diagnose startup issue
- it works on my machine
---
# 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`… install to load the full skill