android-debugging

Diagnose Android and KMP issues via Logcat, ANR traces, and stack traces.

119|14|Updated Mar 1, 2026
One-click install
npx skills add https://github.com/rcosteira79/android-skills --skill android-debugging
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: android-debugging
Source: https://github.com/rcosteira79/android-skills/tree/main/skills/android-debugging
Command: npx skills add https://github.com/rcosteira79/android-skills --skill android-debugging

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides specialized techniques and tools to efficiently diagnose and resolve issues encountered during Android and Kotlin Multiplatform (KMP) development, extending systematic debugging with platform-specific insights.

Core Features & Use Cases

  • Evidence Gathering: Utilizes adb logcat, ANR traces, and memory leak analysis (e.g., LeakCanary) to collect critical diagnostic data.
  • Stack Trace Decoding: Offers methods for decoding obfuscated R8/ProGuard stack traces and diagnosing Gradle build failures.
  • Compose Debugging: Addresses common issues like recomposition bugs and state management problems in Jetpack Compose.
  • Use Case: When an Android app crashes in production, this Skill helps analyze the Caused by: chain in the stack trace, identify potential memory leaks using LeakCanary, and decode R8-obfuscated logs to pinpoint the root cause.

Quick Start

Use the android-debugging skill to analyze the provided crash log and identify the root cause.

Frequently Asked Questions about android-debugging

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

FAQPage Schema
How do I decode an R8 obfuscated stack trace in an Android production crash?

To decode an R8 obfuscated stack trace, you must use the mapping file generated during your release build to translate obfuscated class and method names back to their original form. This allows you to pinpoint the root cause of the crash.

Why does Jetpack Compose recompose excessively and how can I debug it?

Jetpack Compose recomposes excessively due to unstable state inputs or improper state management. Debugging involves analyzing state variables and lifecycle to ensure only affected composables redraw, preventing performance bugs.

What's the best way to analyze ANR traces and memory leaks for Android apps?

Analyzing ANR traces and memory leaks involves collecting diagnostic data using adb logcat and LeakCanary. This evidence gathering identifies blocked main threads and retained object references causing application not responding issues.

How do I troubleshoot Gradle build failures in a Kotlin Multiplatform project?

Troubleshooting Gradle build failures in KMP involves isolating dependency conflicts and configuration issues across target platforms. Analyzing build logs helps identify failing tasks and resolve compilation or resolution errors.

Can I use adb logcat to gather evidence for Android application crashes?

Yes, you can use adb logcat to gather real-time diagnostic evidence for Android crashes. It outputs system logs including stack traces and exception details, which are essential for diagnosing the root cause of application issues.

What are the limitations of using R8 stack trace decoding for debugging?

R8 stack trace decoding relies entirely on the availability of the corresponding mapping file generated during the build. If this file is lost or mismatched, you cannot accurately translate obfuscated logs back to original source code.