env-doctor
by Samuel Rose
Diagnoses why your project will not start. Checks runtime versions, dependencies, environment variables, databases, ports, and build artifacts systematically.
- 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
Free
One-time purchase · Own forever
Included in download
- Downloadable skill package
- Works with Claude Code, Cursor
- 1 permission declared
See it in action
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.
env-doctor
by Samuel Rose
Diagnoses why your project will not start. Checks runtime versions, dependencies, environment variables, databases, ports, and build artifacts systematically.
Free
One-time purchase · Own forever
⚡ Also available via Agensi MCP — your AI agent can load this skill on demand via MCP. Learn more →
Included in download
- Downloadable skill package
- Works with Claude Code, Cursor
- 1 permission declared
- Instant install
See it in action
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.
About This Skill
"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.
📖 Learn more: Best DevOps & Deployment Skills for Claude Code →
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
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.
How to Install
unzip env-doctor.zip -d ~/.claude/skills/Reviews
No reviews yet — be the first to share your experience.
Only users who have downloaded or purchased this skill can leave a review.
No reviews yet — be the first to share your experience.
Only users who have downloaded or purchased this skill can leave a review.
Security Scanned
Passed automated security review
Permissions
Claude Code, Cursor, Windsurf, Roo Code, Trae, and SKILL.md-compatible agents.
Frequently Asked Questions
Learn More About AI Agent Skills
Similar Skills
git-commit-writer
Writes conventional commit messages by analyzing your staged git changes. Detects commit type, scope, and breaking changes automatically.
codex-grade-coding
Turn your AI agent into a senior engineer with strict task classification and verification-driven coding protocols.
code-reviewer
Reviews your code for bugs, security vulnerabilities, logic errors, performance issues, and style violations. Organizes findings by severity and suggests fixes with code examples.
readme-generator
Generates a complete, polished README.md by scanning your actual project structure, dependencies, and code.