Agent skill

nvm-troubleshooting-macos

Diagnose and fix nvm issues on macOS, including zsh/bash profile not loading, PATH priority conflicts, permission errors, and Homebrew Node conflicts. Use when the user reports nvm not found on macOS, nvm command not working in zsh or Terminal, or PATH priority issues after macOS updates.

View SKILL.md on GitHub Repository
Stars 254
Forks 41

Install this agent skill to your Project

npx add-skill https://github.com/partme-ai/full-stack-skills/tree/main/skills/nvm-skills/nvm-troubleshooting-macos

SKILL.md

nvm Troubleshooting (macOS)

Diagnose and fix common nvm problems on macOS including profile loading and PATH conflicts.

Workflow

  1. Run diagnostic checks:

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

  2. Check profile load order (macOS zsh reads these in order):

    • ~/.zshenv (always)
    • ~/.zprofile (login shells)
    • ~/.zshrc (interactive shells)

  3. Fix the most common issue (nvm lines missing from ~/.zshrc):

    bash
    # Add to ~/.zshrc:
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"

  4. Verify the fix:

    bash
    source ~/.zshrc
command -v nvm   # Should print "nvm"
nvm --version
node -v

Note: General verification belongs to nvm-verify. For Linux/WSL issues, use nvm-troubleshooting-linux.

Example file map

  • examples/troubleshooting-macos.md - macOS-specific troubleshooting
  • examples/macos-troubleshooting.md - Additional macOS guidance
  • examples/problems.md - Common problems and solutions
  • examples/compatibility-issues.md - Known compatibility issues

Keywords

macos, zsh, bash, PATH, permissions, troubleshooting, profile, nvm not found

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

partme-ai/full-stack-skills

ocrmypdf-batch

OCRmyPDF batch processing skill — process multiple PDFs, Docker automation, shell scripting, and CI/CD integration. Use when the user needs to OCR many PDFs, set up automated OCR pipelines, or integrate OCR into workflows.

254 41
Explore
partme-ai/full-stack-skills

ocrmypdf-optimize

OCRmyPDF optimization skill — compress PDFs, configure PDF/A output, JBIG2 encoding, and lossless optimization. Use when the user needs to reduce PDF file size, create archival PDF/A files, or optimize OCR output.

254 41
Explore
partme-ai/full-stack-skills

ocrmypdf-image

OCRmyPDF image processing skill — deskew, rotate, clean, despeckle, remove border from scanned documents. Use when the user needs to improve scanned PDF quality, fix skewed pages, remove noise, or clean up scanned documents before OCR.

254 41
Explore
partme-ai/full-stack-skills

ocrmypdf-api

OCRmyPDF Python API and plugin skill — use OCRmyPDF programmatically from Python, integrate with applications, and extend with plugins (EasyOCR, PaddleOCR, AppleOCR). Use when the user needs to call OCRmyPDF from Python code, build OCR pipelines, or use alternative OCR engines.

254 41
Explore
partme-ai/full-stack-skills

ocrmypdf

OCRmyPDF core skill — add searchable OCR text layer to scanned PDFs, convert images to searchable PDFs, support 100+ languages via Tesseract. Use when the user needs to OCR a PDF, make a scanned PDF searchable, or extract text from scanned documents.

254 41
Explore
partme-ai/full-stack-skills

svelte

Guides Svelte and SvelteKit development including reactive components, stores, transitions, lifecycle hooks, SSR, file-based routing, and deployment. Use when the user needs to build Svelte components, create SvelteKit applications, implement reactivity patterns, or configure Svelte with Vite.

254 41
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results