perfetto-trace-analysis

Analyze Perfetto traces to locate verified root causes of Android latency and jank.

1|Updated Mar 17, 2026
One-click install
npx skills add https://github.com/premex-ab/claude-marketplace --skill perfetto-trace-analysis
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: perfetto-trace-analysis
Source: https://github.com/premex-ab/claude-marketplace/tree/main/plugins/android-perfetto-trace-analysis/skills/perfetto-trace-analysis
Command: npx skills add https://github.com/premex-ab/claude-marketplace --skill perfetto-trace-analysis

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Perfetto trace analysis helps you identify why an Android app experiences latency spikes, memory pressure, or UI jank—without guessing from noisy logs.

Core Features & Use Cases

  • Trace-driven root cause finding: Recommends hypotheses and then verifies them with structured evidence from the trace, using an explicit chain of evidence.
  • Domain-hint guided investigation: Uses expert-vetted techniques across CPU, Graphics, I/O, IPC, Memory, and Power to avoid blind troubleshooting.
  • SQL-first Perfetto analysis: Generates and executes Perfetto SQL following the provided SQL execution protocol to ensure queries match trace schemas safely.
  • Works with broad or package-specific requests: If the request is broad, it can first identify the active app package and continue the investigation accordingly.

Quick Start

Ask the AI to analyze the attached Perfetto trace file for the root cause of perceived jank and latency, ensuring it produces a verified chain of evidence.

Frequently Asked Questions about perfetto-trace-analysis

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

FAQPage Schema
How do I find the root cause of Android UI jank using a Perfetto trace?

Perfetto trace analysis identifies the root cause of Android UI jank by generating and executing SQL queries to verify performance hypotheses. It builds a strict chain of evidence across CPU, graphics, and memory domains to pinpoint exact latency sources.

Can I diagnose Android memory pressure from a Perfetto trace file?

Yes, you can diagnose Android memory pressure from a Perfetto trace file. The analysis uses domain-specific hints and SQL queries to investigate memory allocation issues, establishing a verified chain of evidence for the ongoing memory degradation.

What is the best way to troubleshoot Android latency spikes without logcat?

The best way to troubleshoot Android latency spikes without logcat is Perfetto trace analysis. It applies expert-vetted techniques across I/O, IPC, and power domains, using structured SQL evidence rather than noisy logs to locate verified root causes.

Does Perfetto trace analysis work for broad performance investigations without a specific app package?

Yes, Perfetto trace analysis works for broad performance investigations without a specific app package. If a request is open-ended, the analysis first identifies the active app package within the trace and continues the targeted investigation accordingly.

Why does my Android app experience frame drops, and how can trace analysis help?

Android app frame drops stem from CPU, graphics, or I/O bottlenecks, which Perfetto trace analysis helps diagnose. It executes SQL following a defined protocol to safely match trace schemas and extract verified root causes of the perceived jank.