skills.rest
antonyfmunoz
antonyfmunozCOMMUNITY
Explore all skills by this author →
GitHub

nodejs

Resolve Node.js runtime and deployment issues with ESM/CJS and package.json exports.

1|Updated Mar 11, 2026
Search Tags:#performance#debugging#deployment#pnpm#nodejs#esm#runtime-configuration
One-click install
npx skills add https://github.com/antonyfmunoz/OS --skill nodejs-antonyfmunoz
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: nodejs
Source: https://github.com/antonyfmunoz/OS/tree/main/skills/tools/nodejs
Command: npx skills add https://github.com/antonyfmunoz/OS --skill nodejs-antonyfmunoz

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps you correctly run, install, and debug Node.js environments without getting stuck on version mismatches, module system issues (ESM vs CJS), or hard-to-trace performance and reliability problems.

Core Features & Use Cases

  • Node runtime guidance for modern Node.js (22 LTS): choose the right Node version, configure engines and package manager tooling, and avoid CI drift.
  • Practical ESM/CJS and package.json resolution support: prevent common resolution failures (like missing file extensions) and structure exports correctly.
  • Operational debugging and performance tooling: use Node’s built-in inspection and profiling tools for memory/CPU and diagnose event-loop and latency issues.
  • Use Case: You are deploying a Node 22 service behind a load balancer and seeing sporadic 502s; use this Skill to apply the correct keep-alive timeout configuration and identify sync-I/O or event-loop blocking issues.

Quick Start

Use the nodejs skill to diagnose an ESM import error and show the exact Node.js flag and package.json configuration needed to make your service run on Node 22.

Frequently Asked Questions about nodejs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix ESM import errors in Node.js 22?▼

Resolve Node.js ESM import errors by ensuring explicit file extensions in import paths and correctly structuring package.json exports fields, which prevents common module resolution failures when running ESM code on Node 22.

Why does my Node.js service return sporadic 502 errors behind a load balancer?▼

Sporadic 502 errors behind a load balancer often stem from incorrect keepAliveTimeout or headersTimeout settings. This Skill helps identify mismatched timeout configurations and diagnose event-loop blocking causing dropped connections.

How do I profile CPU and memory issues in a Node.js application?▼

Profile CPU and memory issues in Node.js using built-in inspection and profiling commands. This Skill guides diagnosing event-loop latency, separating main-thread CPU work using worker_threads, and applying abortable fetch patterns.

Does pnpm work with Node 22 and how do I prevent CI drift?▼

pnpm works with Node 22 by configuring engines and package manager tooling correctly. This Skill helps select compatible Node versions, configure pnpm/npm, and prevent CI drift by aligning runtime environments.

When should I use worker_threads instead of main-thread CPU work in Node.js?▼

Use worker_threads for heavy CPU work instead of blocking the Node.js main thread. This Skill provides guidance on isolating main-thread CPU tasks to prevent event-loop blocking and performance degradation.

Related Skills

Explore More Software Engineering Skills→
camoneartcamoneart
5

Enforcing pnpm

Enforce pnpm as the exclusive package manager and convert npm/yarn commands.

Community
Basic
softsparksoftspark
161

ci-cd-patterns

Apply reusable CI/CD pattern templates to standardize deployment pipelines.

Community
Intermediate
AndyAnh174AndyAnh174

python-performance-optimization

Profile Python code to identify CPU and memory bottlenecks.

Community
Advanced
nhonvonhonvo

nodejs-expert

Diagnose and optimize Node.js runtime, async patterns, and module resolution.

Community
Advanced