electron-native-rebuild

Diagnose and repair Electron native module ABI mismatches with rebuild scripts.

4|1|Updated Feb 17, 2026
One-click install
npx skills add https://github.com/OpenWaggle/OpenWaggle --skill electron-native-rebuild
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: electron-native-rebuild
Source: https://github.com/OpenWaggle/OpenWaggle/tree/main/.agents/skills/electron-native-rebuild
Command: npx skills add https://github.com/OpenWaggle/OpenWaggle --skill electron-native-rebuild

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps developers identify and repair native-addon compatibility issues in Electron applications, ensuring native modules work seamlessly across different environments.

Core Features & Use Cases

  • Native Module Rebuilds: Guides users through rebuilding native dependencies against Electron headers to resolve ABI mismatches.
  • Troubleshooting Native Errors: Assists in diagnosing errors like missing symbols or architecture mismatches in Electron-native modules.
  • Use Case: A developer upgrading Electron or native modules can utilize this Skill to ensure all native dependencies are correctly rebuilt, avoiding runtime crashes.

Quick Start

Use this Skill to diagnose and repair native module issues in your Electron project by running the provided rebuild scripts and validating the environment setup.

Frequently Asked Questions about electron-native-rebuild

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

FAQPage Schema
How do I fix Electron native module ABI mismatch errors after upgrading?

To fix an Electron native module ABI mismatch, you must rebuild your native dependencies against the specific Electron headers of your target version to restore compatibility and prevent runtime crashes.

Why does my Electron app crash with missing symbols in native modules?

Missing symbols in Electron native modules usually indicate an architecture mismatch or failed native rebuild, requiring you to diagnose the environment setup and recompile the native addon against the correct headers.

What is the best way to rebuild native dependencies for different Electron versions?

The best way to rebuild native dependencies for different Electron versions is to execute dedicated native rebuild scripts that target the specific environment headers, validating the setup to ensure application stability.

When do I need to rebuild native modules in an Electron project?

You need to rebuild native modules in an Electron project whenever you upgrade the Electron version or change environments, ensuring the native addons match the current ABI to avoid runtime failures.

How do I diagnose architecture mismatches in Electron native addons?

To diagnose architecture mismatches in Electron native addons, compare the matrix failure signatures and runtime errors against reference data to identify the specific incompatibility before initiating a native rebuild.