ad-explain

Explains Android debugger pauses by analyzing frame snapshot data.

3|Updated May 10, 2026
One-click install
npx skills add https://github.com/Acendas/android-debugger --skill ad-explain
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ad-explain
Source: https://github.com/Acendas/android-debugger/tree/main/skills/ad-explain
Command: npx skills add https://github.com/Acendas/android-debugger --skill ad-explain

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Explain why the Android debugger paused at a breakpoint by providing grounded, snapshot-based narration, hypotheses, and recommended next steps.

Core Features & Use Cases

  • Frame-snapshot grounded explanations of the pause reason and event context.
  • Hypothesis generation grounded in locals, watches, and frame data, with explicit uncertainty when data is insufficient.
  • Safe, actionable debugging guidance that stays within the VM's safety rules and suggests concrete next steps.
  • Anti-hallucination safeguards referencing the project’s guidelines to ensure explanations are tied to the captured snapshot.

Quick Start

Feed the current frame snapshot to generate a grounded explanation of the pause and suggested next actions.

Frequently Asked Questions about ad-explain

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

FAQPage Schema
How do I explain why the Android debugger paused at a breakpoint?

You can explain why the Android debugger paused by analyzing the current frame snapshot. The tool evaluates locals and watches to generate grounded hypotheses about the pause reason, event context, and recommended next actions for breakpoint hits, step pauses, or exceptions.

What is frame snapshot analysis in Android debugging?

Frame snapshot analysis in Android debugging captures the current execution state, including local variables and call stack data. It grounds reasoning about why a pause occurred, providing narration and hypotheses tied directly to the captured runtime data rather than assumptions.

How do I generate debugging hypotheses from a paused Android app without mutating state?

To generate debugging hypotheses without mutating state, feed the current frame snapshot into the analysis tool. It inspects objects and evaluates expressions read-only, delivering actionable next steps while explicitly avoiding VM state mutation unless explicitly permitted.

Can I use frame snapshot inspection for both breakpoint hits and exception pauses in live Android apps?

Yes, frame snapshot inspection applies to breakpoint hits, step pauses, and exceptions across live Android apps. It analyzes the paused state to deliver grounded explanations and recommended next actions regardless of the specific pause event type.

What should I do when the Android debugger pauses but there is insufficient data to explain why?

When the Android debugger pauses with insufficient data, the analysis tool explicitly states the uncertainty. It references captured snapshot data to avoid hallucination, providing only grounded hypotheses and suggesting concrete next debugging steps.

Does the Android debugger explanation tool require specific dependencies to analyze a pause?

No specific dependencies are required to analyze an Android debugger pause. The tool operates directly on the frame snapshot using built-in inspection and evaluation tools to ground its reasoning and deliver recommended next actions.