env-doctor
Diagnoses why your project will not start. Checks runtime versions, dependencies, environment variables, databases, ports, and build artifacts systematically.
by Samuel Rose
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.
How to Install
unzip env-doctor.zip -d ~/.claude/skills/What This Skill Does
When your project won't start and the error messages aren't helpful, this skill runs a systematic diagnosis. It checks runtime versions (Node, Python, Ruby, Go), missing or outdated dependencies, required environment variables, database connections, port conflicts, and stale build artifacts.
Instead of throwing errors at you one at a time, it works through potential issues in a logical order and tells you exactly what's wrong and how to fix it.
Example Usage
Ask your agent: "My project won't start. Diagnose what's wrong"
Free
One-time purchase • Own forever
Security Scanned
Passed automated security review
6/8 checks passed
Tags
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.
migration-auditor
Catches dangerous database migrations before they hit production. Reviews schema changes for locking hazards, data loss, missing rollbacks, and index issues across PostgreSQL, MySQL, and SQLite.
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.
changelog-generator
Generates user-facing changelogs from git history. Transforms developer commit messages into clear release notes that users actually understand.