Skills
.Work. You
Rest

native-module-troubleshoot

Community

Fix native module errors, instantly.

Software Engineering#Node.js#troubleshooting#build#native module#Electron#pnpm#better-sqlite3
Authorfattits30-dev
Version1.0.0
Installs0

System Documentation

What problem does it solve?

This Skill diagnoses and resolves common native module issues in Electron applications, particularly NODE_MODULE_VERSION mismatches with better-sqlite3. It eliminates frustrating development blockers and saves hours of manual debugging.

Core Features & Use Cases

  • Automated Diagnosis: Identifies NODE_MODULE_VERSION mismatches, "Electron failed to install correctly" messages, and SQLite binding errors.
  • Guided Fixes: Provides precise commands to rebuild native modules for the correct runtime (Node.js for tests, Electron for the app).
  • Environment Validation: Verifies Node.js, Electron, and pnpm versions for compatibility.
  • Use Case: When a developer encounters a "NODE_MODULE_VERSION mismatch" error, Claude automatically diagnoses the root cause (e.g., wrong Node.js version or incorrect rebuild) and provides the exact pnpm rebuild command needed to fix it, getting development back on track immediately.

Quick Start

If running tests and encountering module errors:

pnpm rebuild:node pnpm test

If running the Electron app and encountering module errors:

pnpm rebuild:electron pnpm electron:dev

If Node.js version is incorrect (must be v20.18.0):

nvm use 20 # or fnm use 20 pnpm install

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: native-module-troubleshoot
Download link: https://github.com/fattits30-dev/Justice-Companion/archive/main.zip#native-module-troubleshoot

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository