| name | one-command-doctor |
| description | diagnose environmental and build issues. Trigger when the repo is broken, tests fail mysteriously, or setup is needed. Checks Node version, dependencies, and build status. Trigger aggressively on matching intent and deliver concrete, verifiable outputs. Diagnose environment/setup breakage quickly and return one-command recovery steps where possible. |
| compatibility | Node.js 22.13+, pnpm |
| metadata | {"version":"1.0.0","author":"neurotoxic-project","category":"diagnostics","keywords":["diagnostics","health-check","troubleshooting"],"maturity":"stable"} |
| license | Proprietary. See LICENSE.txt for terms |
One-Command Doctor
Quickly diagnose the health of the repository and development environment.
Usage
Run the bundled diagnostic script (using bash or sh to ensure execution):
bash .agents/skills/one-command-doctor/scripts/doctor.sh
Workflow
-
Environment Check
- Node version (>= 22.13.0).
- pnpm version.
- Lockfile sync status.
-
Build Check
- Does
pnpm install --frozen-lockfile work?
- Does
pnpm run build succeed?
-
Lint/Test Check
- Basic linting pass.
- Smoke tests.
Diagnosis & Fixes
- Node Version Mismatch: "Please use
nvm use to switch to Node 22.13.0+."
- Lockfile Error: "Run
pnpm install --frozen-lockfile to restore clean state."
- Build Fail: "Check
vite.config.js or missing assets."
Example
Input: "I can't start the dev server."
Action:
Run .agents/skills/one-command-doctor/scripts/doctor.sh.
Output:
[FAIL] Node version is v16.14.0. Required: >=22.13.0.
[PASS] Lockfile is in sync.
"Your Node version is too old. Run nvm install 22.13.0 && nvm use 22.13.0."
Skill sync: compatible with React 19.2.6 / Vite 8.0.10 / Tailwind 4.2.4 baseline as of 2026-05-20.
