teachingai/nvm-troubleshooting-macos
skills/nvm-skills/nvm-troubleshooting-macos/SKILL.md
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.
$ install --global
skillsauthnpx skillsauth add teachingai/agent-skills nvm-troubleshooting-macosInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 10, 2026, 8:49 AM312.9s6 files scanned
SKILL.md
- name:
- nvm-troubleshooting-macos
- description:
- 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.
- license:
- Complete terms in LICENSE.txt
nvm Troubleshooting (macOS)
Diagnose and fix common nvm problems on macOS including profile loading and PATH conflicts.
Workflow
-
Run diagnostic checks:
echo "Shell: $SHELL" echo "NVM_DIR: $NVM_DIR" cat ~/.zshrc | grep -n nvm echo $PATH | tr ':' '\n' | head -10 -
Check profile load order (macOS zsh reads these in order):
~/.zshenv(always)~/.zprofile(login shells)~/.zshrc(interactive shells)
-
Fix the most common issue (nvm lines missing from
~/.zshrc):# 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" -
Verify the fix:
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 troubleshootingexamples/macos-troubleshooting.md- Additional macOS guidanceexamples/problems.md- Common problems and solutionsexamples/compatibility-issues.md- Known compatibility issues
Keywords
macos, zsh, bash, PATH, permissions, troubleshooting, profile, nvm not found
Related Skills
teachingai/nextjs
development
VerifiedTrustedCommunity
Guidance for Next.js using the official docs at nextjs.org/docs. Use when the user needs Next.js concepts, configuration, routing, data fetching, or API reference details.
284SKILL.mdUpdated Apr 14, 2026
teachingai/flask
tools
VerifiedTrustedCommunity
Provides comprehensive guidance for Flask framework including routing, templates, forms, database integration, extensions, and deployment. Use when the user asks about Flask, needs to create web applications, implement routes, or build Python web services.
284SKILL.mdUpdated Apr 14, 2026
teachingai/fastapi
development
VerifiedTrustedCommunity
Provides comprehensive guidance for FastAPI framework including routing, request validation, dependency injection, async operations, OpenAPI documentation, and database integration. Use when the user asks about FastAPI, needs to create REST APIs, or build high-performance Python web services.
284SKILL.mdUpdated Apr 14, 2026
teachingai/django
development
VerifiedTrustedCommunity
Provides comprehensive guidance for Django framework including models, views, templates, forms, admin, REST framework, and deployment. Use when the user asks about Django, needs to create web applications, implement models and views, or build Django REST APIs.
284SKILL.mdUpdated Apr 14, 2026