Full-stack-skills nvm-troubleshooting-linux

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.

install
source · Clone the upstream repo
git clone https://github.com/partme-ai/full-stack-skills
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/partme-ai/full-stack-skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/nvm-skills/nvm-troubleshooting-linux" ~/.claude/skills/partme-ai-full-stack-skills-nvm-troubleshooting-linux && rm -rf "$T"
manifest: skills/nvm-skills/nvm-troubleshooting-linux/SKILL.md
source content

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