Env Doctor Pro — Why Won't This Repo Start
Diagnose why a project won't install or boot: toolchain, lockfiles, missing env keys, ports — confirm before every write.
$29
Works with the AI Agents you already use
Env Doctor Pro — Why Won't This Repo Start
Example session with this skill installed
The project won't start. I'm getting a module not found error when I run npm run dev, but I already ran npm install. Here is the log.
- Read your context and instructions
- Compiled the env doctor pro
I have analyzed the startup failure and scanned the local configuration files. It appears there is a mismatch between your installed dependencies and the required Node.js version.
Env Doctor report
Symptom: Error: Cannot find module 'lucide-react' during next dev.
Likely cause: Stale node_modules / Node version mismatch (High confidence).
Evidence:
package.jsonengines specifynode >=20.0.0, but current shell isv18.16.0.package-lock.jsonwas generated withnpm v10, current isnpm v9.6.7.lucide-reactis present inpackage.jsonbut missing fromnode_modules/.bin.
Fix plan
- Use
nvm useor switch shell to Node v20.0.0. [needs confirm] - Verify
.envmatches.env.examplekeys. [read-only] - Run
npm installto sync lockfile with node_modules. [needs confirm] - Check if port 3000 is occupied by another process. [read-only]
Next command
npm run dev
Next steps
- Would you like me to attempt switching the Node version using your version manager?
- Should I proceed with a clean
npm installonce the version is corrected? - I can also check your
.envfile for missing keys from the example file.
Connects securely to your tools. The creator never sees your data.
About this skill
Stop wasting hours troubleshooting local environment mismatches and cryptic install errors. This skill automates the diagnostic process for projects that refuse to boot, install, or run. It systematically audits Node and Python toolchains, lockfile integrity, missing environment variables, and port conflicts to find exactly why a repo is failing.
What it does
- Reproduce failures by capturing exact command signals and exit codes.
- Scan toolchains to compare runtime versions against
.nvmrc,engines, orruntime.txt. - Audit lockfiles for mismatches between
npm,pnpm,yarn,uv, orpoetry. - Identify env gaps by checking
.env.examplekeys against active processes. - Rank root causes using a failure matrix to assign confidence levels to potential fixes.
How it works
- Symptom Capture: Provide the failing command and error log; the skill extracts the crash signature.
- Diagnostic Scan: The agent performs a read-only audit of configuration files and system paths.
- Report Generation: You receive a prioritized list of causes with specific evidence from your filesystem.
- Fix Approval: The agent proposes a plan, labeling steps as either safe read-only actions or system-altering writes.
- Guided Execution: Upon confirmation, the agent applies the fix and verifies the boot sequence.
Frameworks & tools
Supports Node.js (npm, pnpm, yarn), Python (venv, poetry, uv), Docker, and standard Unix/Windows shell environments.
Why this beats prompting it yourself
Standard prompts often suggest destructive "shotgun" fixes like deleting node_modules or upgrading all packages immediately. This skill enforces a strict scan-order and failure-matrix approach, ensuring the smallest possible change unblocks the project without polluting your global environment.
Use cases
- Debugging a legacy repo that fails to install on a new machine.
- Fixing "module not found" or "wrong node version" errors during onboarding.
- Resolving port conflicts and missing
.envkeys in complex microservices. - Verifying lockfile integrity after a messy git merge.
Known limitations
Does not support automatic Docker Desktop installation or private registry credential management. User must provide project root for monorepos.
Requires shell access for diagnostics. Does not install Docker or manage private registry credentials. Destructive resets require explicit confirmation.
How to use
- 1
Connect your agent to the Agensi MCP
Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup
- 2
Sign in to Agensi
Your agent shows a sign-in link. Sign in and click Allow.
- 3
Ask for what you need
Your agent loads this skill and uses it on your task. It always asks before any payment.
Reviews
No reviews yet
Be one of the first to try it. Every listed skill goes through the trust checks below.
Security scanned
Checked by our 8-point scan before listing
Fresh listing
Recently published to Agensi
Money-back guarantee
Doesn't do what its page promises? You get your money back.
Trust & safety
Security scan
Security scan passed 24 days ago
Requires
Permissions
No special permissions declared or detected