Skip to main content
PROMPT SPACE
E
Freedeveloper-tools

env-doctor

Diagnoses why your project will not start. Checks runtime versions, dependencies, environment variables, databases, ports, and build artifacts systematically.

skill install https://www.promptspace.in/skills/env-doctor

"It works on my machine" ends here. This skill runs a systematic health check on any project: verifies runtime versions match requirements, checks for missing or conflicting dependencies, diffs your .env against .env.example to find missing variables, checks if databases and services are running, detects port conflicts, and verifies build artifacts exist. It reports every issue with the exact command to fix it. Works with Node.js, Python, Rust, Go, Ruby, and Docker projects. Never prints your secret values.

Use cases

  • Identify missing environment variables by comparing with template files
  • Detect active port conflicts and provide commands to kill blocking processes
  • Verify runtime versions match project engine requirements across languages
  • Validate database connectivity and check for missing service dependencies
  • Locate broken build artifacts and suggest specific rebuild instructions

Example

Prompt

Ask your agent: "My project won't start. Diagnose what's wrong"

Output

Identified missing .env fields: STRIPE_KEY and DB_PASSWORD. Found port 3000 occupied by PID 4421. Docker containers for 'redis' are exited. Fix: cp .env.example .env && kill -9 4421.

Known limitations

- Cannot verify the internal credentials (passwords/keys) are actually valid. - Limited to local environment checks; cannot diagnose cloud-provider specific IAM or VPC issues.

Frequently asked questions

No. The skill is designed with security in mind: it checks for the existence of keys and looks for placeholder patterns, but it is explicitly programmed to never output or log the actual secret values.