Best fit
Diagnoses local setup failures across Node, Python, Go, and Docker: missing dependencies, broken env vars, port conflicts, and stale installs, then returns copy-paste bash fixes.
// developer tools
Env Doctor
Diagnose the "it works on my machine" problem safely before you touch the code.
What it does
Half a day disappears into setup sludge: a project that will not start, an env-var key nobody documented, a port owned by another service, or an install that went stale three branches ago. Env Doctor walks the usual failure points across Node, Python, Go, and Docker and tells you what is actually wrong.
Each finding includes a next step for the detected system: PowerShell on Windows or Bash on macOS and Linux. It compares environment-variable names and empty states without displaying values, identifies the owner of a busy port, and asks before any stop action. Nothing changes on your machine without you.
What it checks
- Missing dependencies and tools the project expects.
- Missing or empty environment-variable keys, without reading values into the report.
- Port conflicts, with PID, executable, and available service ownership evidence.
- Stale installs and lockfile drift.
- Runtime and version mismatches.
- A shell-specific next step for each problem it finds.
What the output looks like
$ env-doctor
x NODE_ENV is missing (value not displayed)
x port 5432 owned by postgres (PID 8123)
next use the matching PowerShell or Bash command
safe confirm ownership before any stop action
Use the ordered startup checklist
The app-won't-run-locally guide shows how to preserve the first useful error, verify runtimes and lockfiles, compare environment-variable names without exposing values, identify the owner of a port, and hand a healthy environment into application-level diagnosis.
// independent directory review
Skillstore labels Env Doctor v1.3.0 Safe
Skillstore's versioned review covers the same three-file package linked from this page. It scanned 441 lines, found no confirmed security findings, and reports that the skill keeps diagnostics local, suppresses environment values, and requires approval before stopping a process.
This is review evidence, not a guarantee of no side effects. Read the full Skillstore audit.
// choose with context
Is Env Doctor the right skill?
It returns
Diagnoses local setup failures across Node, Python, Go, and Docker: missing dependencies, broken env vars, port conflicts, and stale installs, then returns copy-paste bash fixes.
Do not use it as
Do not treat a successful run as proof beyond the supplied files, declared scope, and evidence the skill actually checked.
Compatibility, access, version, and licence
- Reads or accesses
- Only the files or context you deliberately provide; review the listing before granting additional access.
- Compatibility
- Agents that read the open SKILL.md format. Verify runtime and service requirements at the purchase or install destination.
- Version
- Verify the current package version at the linked destination.
- Licence
- MIT
Install the public package
Inspect the source and permissions first, then install only this skill:
npx skills add https://justhandledlabs.com --skill env-doctor-freeRead the immutable SKILL.md source · See all public install options
Questions
Does it change my system?
No. It diagnoses and recommends shell-specific next steps. It asks before any process stop and never displays or retains .env values.
Which systems and stacks does it cover?
Windows PowerShell, macOS, and Linux projects using Node, Python, Go, or Docker.
What kind of problems does it catch?
Missing dependencies, missing or empty environment-variable keys, port ownership conflicts, stale installs, lockfile drift, stopped services, and runtime version mismatches.
Install it directly or inspect the source
This free skill is public. Review the exact files first, or install only this skill from the JustHandled Labs repository.
npx skills add justhandledlabs/skills --skill env-doctor-freeFrom "why won't this run" to running.
Free on Agensi. Instant download. Works with any agent that reads SKILL.md.
Get Env Doctor on Agensi