diagnosing-stacktrace-symbolication
Installation
SKILL.md
Diagnosing stack-trace symbolication
Symbolication is the cross-platform name for what JavaScript source-map lookup, Hermes function-offset resolution, Proguard / R8 demangling, and dSYM address-to-line lookup all do — turn a minified or obfuscated frame back into a readable file, function, and line.
Work through the user's build and PostHog symbol sets as one pipeline: build config -> generated symbol artifacts (JavaScript source maps, Hermes maps, Proguard mappings, or dSYM bundles) -> uploaded symbol set in PostHog -> captured error frame. Most failures become obvious once those four pieces are checked in order.
Platforms
| Platform | Symbol-data type | Reference |
|---|---|---|
| JavaScript / TypeScript web | source-and-map | javascript.md |
| React Native (Hermes) | hermes | coming soon |
| Android (Proguard / R8) | proguard | coming soon |
| iOS / macOS (dSYM) | apple-dsym | coming soon |