mobile-debug

Automate mobile crash triage and root-cause debugging across React Native, Flutter, and native iOS/Android.

13|3|Updated Mar 27, 2026
One-click install
npx skills add https://github.com/heaptracetechnology/heaptrace-skills --skill mobile-debug
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mobile-debug
Source: https://github.com/heaptracetechnology/heaptrace-skills/tree/main/mobile/mobile-debug
Command: npx skills add https://github.com/heaptracetechnology/heaptrace-skills --skill mobile-debug

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Investigate and fix mobile app crashes, memory leaks, ANRs, and performance issues across React Native, Flutter, and native iOS/Android. It follows a structured debugging flow: read crash log → symbolicate → classify → isolate platform vs framework → fix → verify on device.

Core Features & Use Cases

  • Cross-platform crash triage and root-cause analysis for mobile apps
  • Memory leak detection, ANR analysis, and performance profiling guidance
  • Step-by-step workflow from crash intake to on-device verification and fix validation

Quick Start

Run a full mobile debug cycle on a device to locate and fix crashes, ANRs, and memory issues.

Frequently Asked Questions about mobile-debug

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

FAQPage Schema
How do I debug a mobile app crash on launch across React Native and Flutter?

To debug a mobile app crash on launch, you need to read the crash log, symbolicate it, classify the issue, and isolate whether it stems from the platform or the framework. This structured workflow triages root causes across React Native, Flutter, and native iOS/Android.

What is the best way to analyze ANR issues and memory leaks in cross-platform mobile apps?

Analyzing ANR issues and memory leaks requires applying memory diagnostics and performance profiling to isolate the root cause. A structured debugging flow identifies whether the issue originates in the native layer or the cross-platform bridge, enabling targeted fixes verified on real devices.

Does this mobile debugging workflow support both native iOS/Android and cross-platform frameworks?

Yes, this mobile debugging workflow supports native iOS/Android alongside cross-platform frameworks like React Native and Flutter. It isolates platform-specific versus framework-level issues, applying memory, network, and bridge diagnostics to pinpoint problems across multi-platform projects.

How do I symbolicate a crash log to find the root cause of a mobile app crash?

To symbolicate a crash log and find the root cause, you map the raw stack trace back to your source code. This workflow automates crash triage by reading the log, symbolicating it, and classifying the error to isolate the specific platform or framework failure.

Can I run a full mobile debug cycle for performance issues on a real device?

Yes, you can run a full mobile debug cycle for performance issues on a real device. The process guides you from crash intake and symbolication through to on-device verification and fix validation for ANRs, memory leaks, and crashes.

Why does my React Native app crash when the native bridge fails, and how do I isolate it?

A React Native app crashes when the native bridge fails due to communication breakdowns between JavaScript and native code. You isolate it by applying bridge diagnostics to classify the crash, separating framework errors from native iOS or Android platform issues.