nodejs-runtime

A setup and troubleshooting guide for Node.js, the software that runs JavaScript outside a web browser, and its package managers such as npm, pnpm, and yarn.

In plain words
What is it for?
Use it to install or upgrade Node.js, switch between versions, manage npm, pnpm, or yarn, and fix common runtime issues.
Why use it?
It helps resolve missing commands, version conflicts, permission errors, package-manager setup, and native build problems.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/desirecore/market/nodejs-runtime
Any agent
npx skills add desirecore/market --skill nodejs-runtime
Clone the repo
git clone --depth 1 https://github.com/desirecore/market

Made for: Claude Code, Codex.

Per session 230 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,723 The whole file, excluding the scripts and references it only reads on demand.
Security scan D 3 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00230 $0.02723
Opus 5 $0.00115 $0.01362
Sonnet 5 $0.00046 $0.00545
Haiku 4.5 $0.00023 $0.00272

Measured yesterday against content hash 7c71b82b7f5f, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade D, and why

nodejs-runtime scanned grade D with 3 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.

The scan reads SKILL.md. This mod also ships 1 executable file (scripts/probe-node.sh), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Asks for rootmediumPrivilege escalation

A mod that escalates privileges can change anything on the machine, not only the project.

| Debian/Ubuntu | NodeSource: `curl -fsSL https://deb.nodesource.com/setup_22.x \| sudo -E bash - && sudo apt install nodejs` |

Downloads and executes remote codehighSupply chain

curl | sh runs whatever the server returns today, which is not necessarily what it returned when this was reviewed.

| Fedora/RHEL | `curl -fsSL https://rpm.nodesource.com/setup_22.x \| sudo bash - && sudo dnf install nodejs` |

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

curl -sk "${BASE}/node/available"
skills/nodejs-runtime/SKILL.md · 216 lines

How it starts

The opening of the file, as written. The whole thing — 216 lines — stays where its author put it; the contents beside it link to each section on GitHub.

nodejs-runtime Skill

L0: One-line Summary

When to use: the user needs to install Node.js / upgrade Node / switch Node multi-version / install or configure npm / pnpm / yarn / troubleshoot node: command not found, npm: command not found, EACCES global install permission errors, node-gyp build failures, registry mirror / proxy issues, or other Node.js runtime problems, or when other skills (pptx using pptxgenjs, etc.) report "Node.js unavailable".

How: prefer the DesireCore built-in Volta and follow a four-tier fallback (HTTP API → Volta CLI → system package manager brew/apt/NodeSource/winget → community options nvm/fnm).

L1: Overview and Use Cases

Capability Description

Procedural skill. Before each Node.js environment operation, run scripts/probe-node.sh to obtain a JSON snapshot, then choose a path according to the four-tier fallback in ../dev-environment-setup/references/decision-tree.md.

Use Cases

  • "node not found" / "npm not found"
  • The user requests to install/upgrade Node.js
  • Multi-version switching (based on package.json#volta or .nvmrc)
  • Install/manage pnpm / yarn / npm
  • "EACCES: permission denied" (npm global install permission error)
  • Configure registry / proxy
  • Other skills (pptx, etc.) report Node.js unavailable

Core Value

  • DesireCore first: Volta + HTTP API as L1/L2, avoiding pollution of the system Node
  • JSON-driven decisions: the probe script outputs structured data that Claude can parse directly
  • package.json#volta compatible: Volta automatically switches versions per project

L2: Detailed Specification

Step 1: Environment Probe (mandatory)

bash skills/nodejs-runtime/scripts/probe-node.sh > /tmp/node-probe.json
cat /tmp/node-probe.json | jq .

See ../dev-environment-setup/references/probe-snapshot.md for field definitions.

Step 2: Choose an Execution Path

Condition Path
desirecore_api non-empty L1 HTTP API
desirecore_api empty, volta_path non-empty L2 Volta CLI
Neither of the above L3 System package manager (brew / apt / NodeSource / winget)
L1–L3 all fail or user explicitly requests L4 Community options (nvm / fnm)

Read the full file on GitHub · 216 lines

Files

What ships with it

6 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. yesterday First seen · 216 lines · 230 tokens per session scan D 7c71b82b7f5f

Subscribe to this mod's changes

nodejs-runtime is a skill published in the GitHub repository desirecore/market (2 stars, last pushed 2d ago), licensed MIT. It adds 230 tokens to every session and 2,723 once invoked, about $0.0011 per session on Opus 5. A static security scan graded it D with 3 findings (asks for root, downloads and executes remote code, makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

npm-security

Prevent JavaScript/TypeScript projects from supply-chain attacks across package managers like npm, pnpm, yarn, bun, and deno. Use whenever planning, installing, updating packages or configuring package managers.

bodadotsh/npm-security-best-practices · 43 tokens

dependency-audit

依赖漏洞审计。适用于 npm、yarn、pnpm、lockfile、本地目录和远程 Git 仓库的依赖风险审计场景;前端项目的依赖漏洞审计优先使用 locklens。.

BARMPlus/locklens · 56 tokens

tiny-web-crawler

Crawl from one or more starting web pages, fetch readable content, search within pages, follow relevant links, and stop when the requested information is found or a bounded limit is reached.

leon-ai/leon · 42 tokens

playwright-cli

Automates browser interactions for web testing, form filling, screenshots, and data extraction. Use when the user needs to navigate websites, interact with web pages, fill forms, take screenshots, test web applications, or extract information from web pages.

VoltAgent/voltagent · 52 tokens

opendia-harness

Install, configure, and troubleshoot OpenDia for Grok Build (and other MCP harnesses). Use when setting up the plugin, config.toml MCP entry, ports, extension disconnects, tool timeouts, or tunnel mode.

aeonfun/opendia · 52 tokens

stock-api

Fetch real-time stock quotes, K-line (candlestick) history, and search symbols for China A-shares, Hong Kong, and US markets. Use when the user asks for a stock price, a quote, market data, candlestick/K-line data, or to look up a stock code by company name.

zhangxiangliang/stock-api · 66 tokens