nodejs-version-setup

---
name: "nodejs-version-setup"
description: "Ensures Node.js commands run with the project-required Node version before install, build, test, or scripts."
license: "MIT"
---

# nodejs-version-setup

Set and verify the correct Node.js runtime for this repository before running any Node.js command.

## When to use

Use this skill whenever the task runs Node.js tooling, including `npm`, `pnpm`, `yarn`, `npx`, build scripts, tests, linters, or local CLIs.

## Instructions

1. Detect the required Node.js version in this order:
   - `.nvmrc`
   - `.node-version`
   - `package.json` -> `engines.node`
2. Detect an installed version manager in this order:
   - `nvm`
   - `fnm`
   - `asdf`
   - `volta`
3. Select the required version with the first available manager:
   - `nvm`: `nvm install` and `nvm use`
   - `fnm`: `fnm install` and `fnm use`
   - `asdf`: `asdf install nodejs <version>` and `asdf local nodejs <version>`
   - `volta`: `volta install node@<version>`
4. If no version file exists but `engines.node` exists, resolve a concrete version inside that range and install/use it with the detected manager.
5. If no manager is available, check whether the current `node -v` satisfies the required version. If it does not, stop and ask the user to confirm whether to install a version manager or proceed manually.
6. Verify runtime before executing project commands:
   - `node -v`
   - `npm -v` (or `pnpm -v` / `yarn -v` depending on the project)
   - `which node` to confirm the active binary path
7. In task output, report which source defined the version (for example `.nvmrc`), which manager was used, and the final `node -v`.
8. Do not run dependency install, build, test, or CLI scripts until version selection and verification are complete.