nodejs-core

Debug C++ bindings and V8 internals to resolve Node.js native addon crashes.

1|Updated Mar 14, 2025
One-click install
npx skills add https://github.com/JYbill/bullboard-nestjs --skill nodejs-core-jybill
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: nodejs-core
Source: https://github.com/JYbill/bullboard-nestjs/tree/main/.claude/skills/nodejs-core
Command: npx skills add https://github.com/JYbill/bullboard-nestjs --skill nodejs-core-jybill

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Debugging crashes and performance issues in Node.js native addons by inspecting C++ bindings, V8 internals, and libuv event loop.

Core Features & Use Cases

  • Diagnose segfaults, memory leaks, and hangs in native modules and bindings.
  • Guide for using gdb/lldb, Valgrind/ASan, V8 profiling, and N-API debugging patterns.
  • Apply across Windows/macOS/Linux builds, including node-gyp/binding.gyp workflows.

Quick Start

Start a debugging session with gdb or lldb against your Node.js process, then load V8 internals and inspect native stack frames to identify root causes.

Frequently Asked Questions about nodejs-core

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

FAQPage Schema
How do I debug a segmentation fault in Node.js native addons?▼

Debug segmentation faults in Node.js native addons by attaching gdb or lldb to the process, loading V8 internals, and inspecting native C++ stack frames to identify the root cause.

What is the best way to trace memory leaks in Node.js native modules?▼

Trace memory leaks in Node.js native modules by using Valgrind or AddressSanitizer (ASan) alongside V8 profiling tools to detect memory allocation issues within your C++ bindings.

How do I resolve libuv event loop stalls caused by native code?▼

Resolve libuv event loop stalls by profiling your Node.js process to identify blocking operations in native code, then applying V8 tracing to inspect the stalled event loop frames.

Can I use gdb and lldb to debug Node.js native addons across different operating systems?▼

Yes, you can debug Node.js native addons across Windows, macOS, and Linux by using gdb for Linux and lldb for macOS, allowing you to inspect C++ bindings consistently across platforms.

How do I fix node-gyp build-time issues for Node.js native addons?▼

Fix node-gyp build-time issues by examining your binding.gyp workflows and ensuring your C++ bindings correctly compile across Windows, macOS, and Linux environments before runtime debugging.

When should I use N-API debugging patterns for Node.js native addons?▼

Use N-API debugging patterns when diagnosing crashes and performance issues in Node.js native addons, as these patterns help inspect C++ bindings and V8 internals more effectively during native module troubleshooting.