android-perfetto-analyze

Analyze Android Perfetto traces with trace_processor SQL and produce verdict-ready findings.

7|Updated Apr 15, 2026
One-click install
npx skills add https://github.com/himattm/skills --skill android-perfetto-analyze
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: android-perfetto-analyze
Source: https://github.com/himattm/skills/tree/main/plugins/android/skills/android-perfetto-analyze
Command: npx skills add https://github.com/himattm/skills --skill android-perfetto-analyze

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Analyzing Android Perfetto traces often requires manual query setup and data wrangling. This skill provides a repeatable workflow that translates a .perfetto-trace into precise measurements and actionable findings using trace_processor SQL and a small, digestible verdict.

Core Features & Use Cases

  • Install and cache trace_processor if needed
  • Select and run a matching SQL recipe against the trace
  • Produce a compact text result and delegate parsing to a Sonnet sub-agent
  • Iterate queries to narrow down performance issues across frames, threads, and slices
  • Use cases include frame-budget analysis, main-thread work, GC pauses, and IPC costs

Quick Start

Provide a .perfetto-trace file and the skill will run the appropriate trace_processor query to produce a concise, verdict-ready result.

Frequently Asked Questions about android-perfetto-analyze

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

FAQPage Schema
How do I analyze an Android Perfetto trace to extract specific performance metrics?

You can analyze an Android Perfetto trace by running trace_processor SQL queries against your .perfetto-trace file. This workflow extracts concrete metrics like frame timings and thread workloads, outputting clearly labeled findings suitable for performance reports.

What is the best way to identify main-thread work and GC pauses in a Perfetto trace?

Identifying main-thread work and GC pauses is best done using SQL recipes on a .perfetto-trace. The workflow executes targeted trace_processor queries, iterates to narrow down slices, and delegates parsing to a sub-agent for a concise verdict on performance issues.

Do I need to manually install trace_processor to run SQL queries on my .perfetto-trace?

You do not need to manually install trace_processor to run SQL queries. The analysis workflow automatically installs and caches the trace_processor if needed, selecting an appropriate SQL recipe to execute against your provided .perfetto-trace file.

Can I use SQL to measure IPC costs and frame-budget issues in Android profiling?

Yes, you can use SQL to measure IPC costs and frame-budget issues in Android profiling. Running trace_processor SQL recipes against a .perfetto-trace allows the workflow to iterate queries across frames, threads, and slices to extract these precise measurements.

How does a Perfetto trace analysis workflow generate actionable performance findings?

A Perfetto trace analysis workflow generates actionable findings by running SQL queries and writing results to a text file. A Sonnet sub-agent then parses this data to deliver a small, digestible verdict with guidance on next steps for performance issues.

What are the limitations of using trace_processor SQL for Android performance profiling?

Using trace_processor SQL for Android performance profiling requires a provided .perfetto-trace file and depends on iterating queries to narrow down issues. Outputs are compact text findings, meaning complex visual trace exploration is outside this SQL-driven workflow's scope.