Agent-Skills.md

Agent Skills: nvm Troubleshooting (Linux/WSL)

Diagnose and fix nvm issues on Linux and WSL, including profile not loading, PATH errors, distro-specific differences, and Alpine compatibility problems. Use when the user reports nvm not found on Linux, nvm command not working in WSL, or distro-specific nvm issues.

UncategorizedID: teachingai/full-stack-skills/nvm-troubleshooting-linux

Repository

teachingai/full-stack-skills
partme-aiLicense: NOASSERTION
20635

Install this agent skill to your local

pnpm dlx add-skill https://github.com/partme-ai/full-stack-skills/tree/HEAD/skills/nvm-skills/nvm-troubleshooting-linux

Skill Files

Browse the full folder contents for nvm-troubleshooting-linux.

Download Skill

Loading file tree…

skills/nvm-skills/nvm-troubleshooting-linux/SKILL.md

Skill Metadata

Name
nvm-troubleshooting-linux
Description
"Diagnose and fix nvm issues on Linux and WSL, including profile not loading, PATH errors, distro-specific differences, and Alpine compatibility problems. Use when the user reports nvm not found on Linux, nvm command not working in WSL, or distro-specific nvm issues."

nvm Troubleshooting (Linux/WSL)

Diagnose and fix common nvm problems on Linux distributions and Windows Subsystem for Linux.

Workflow

  1. Run diagnostic checks:

    echo "Shell: $SHELL"
echo "NVM_DIR: $NVM_DIR"
cat ~/.bashrc | grep -n nvm
echo $PATH | tr ':' '\n' | grep nvm

  2. Identify the distro and shell:

    cat /etc/os-release | head -2
echo $SHELL
# WSL check:
uname -r | grep -i microsoft && echo "WSL detected"

  3. Fix profile loading issues (most common problem):

    # Ensure these lines are in ~/.bashrc (not just ~/.profile):
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"

  4. Verify the fix:

    source ~/.bashrc
command -v nvm   # Should print "nvm"
nvm --version

Note: Installation steps belong to nvm-install. For macOS issues, use nvm-troubleshooting-macos.

Example file map

  • examples/troubleshooting-linux.md - Linux-specific troubleshooting
  • examples/wsl-troubleshooting.md - WSL-specific issues
  • examples/alpine-install.md - Alpine Linux guidance
  • examples/problems.md - Common problems and solutions
  • examples/compatibility-issues.md - Known compatibility issues

Keywords

linux, wsl, troubleshooting, PATH, profile, compatibility, alpine, nvm not found