symbolicate-crash-dump

Symbolicate native VS Code crash dumps into readable backtraces using electron-minidump.

10|1|Updated Jul 13, 2026
One-click install
npx skills add https://github.com/KevinHuangIsLearning/shortestpath-ide --skill symbolicate-crash-dump-kevinhuangislearning
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: symbolicate-crash-dump
Source: https://github.com/KevinHuangIsLearning/shortestpath-ide/tree/main/.github/skills/symbolicate-crash-dump
Command: npx skills add https://github.com/KevinHuangIsLearning/shortestpath-ide --skill symbolicate-crash-dump-kevinhuangislearning

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires electron-minidump.

What problem does it solve? Native VS Code crash dumps (.dmp files) contain raw memory addresses instead of readable method names, making it nearly impossible to identify which module or process caused a crash without the correct symbol files. ## Core Features & Use Cases - Crash Dump Symbolication: Converts .dmp files into readable backtraces with method names using electron-minidump and Breakpad symbol files. - Symbol Acquisition Guidance: Walks through downloading matching symbol zips from microsoft/vscode-electron-prebuilt (Insiders/Stable) or electron/electron releases (Code - OSS), matched by Electron version, quality, platform, and architecture. - Root Cause Analysis: Identifies the crashing module (first-party vs third-party DLL) and process type (main, renderer, GPU, or extension host via node.mojom.NodeService markers). - Use Case: A user reports an extension host crash-loop on Windows. You obtain the .dmp file, run electron-minidump, copy the matching-hash .sym files into the cache, re-run symbolication, and confirm the crash originates in a third-party antivirus DLL injected into the NodeService utility process. ## Quick Start Symbolicate the attached crash dump file crash-file.dmp and tell me which module and process caused the crash.

Frequently Asked Questions about symbolicate-crash-dump

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

FAQPage Schema
How do I symbolicate a VS Code crash dump file?▼

Install electron-minidump globally via npm, then run electron-minidump crash-file.dmp to generate a backtrace. If frames lack method names, download the matching symbol zip for your build and copy the .sym files into the electron-minidump breakpad_symbols cache, then re-run.

Where do I download Electron symbol files for VS Code crashes?▼

Insiders and Stable builds use symbol zips from the private microsoft/vscode-electron-prebuilt releases, downloaded with an authenticated GitHub CLI. Code - OSS builds use public symbols from electron/electron releases. Match by Electron version, quality, platform, and architecture.

Can I symbolicate crash dumps on Windows?▼

No, electron-minidump does not run on Windows; a macOS or Linux device is required to perform symbolication. However, you can symbolicate dumps produced by Windows builds as long as you run the tool on macOS or Linux.

Why are method names still missing after adding symbol files?▼

Breakpad matches symbols by exact debug-id, not version name, so the .sym file hash must exactly match what the cache directory expects. Some modules like runtime.node and third-party DLLs have no public symbols at all and cannot be symbolicated.

How do I identify which process crashed from a dump file?▼

Run strings on the dump and grep for markers like --type=renderer, --type=gpu-process, or node.mojom.NodeService. The NodeService utility marker indicates the extension host, since modern Electron runs it inside a Node utility process.

How do I debug a remote extension host crash on Linux?▼

Remote server extension host crashes use core dumps and gdb instead of electron-minidump. Enable core dumps with ulimit -c unlimited, retrieve the core via coredumpctl, then load it with gdb against the server's node binary and run bt full.