https://developer.android.com/agents/skills/profilers/perfetto-trace-analysis/skill

Community

Pinpoint Perfetto trace bottlenecks fast.

Authorfornewid
Version1.0.0
Installs0

System Documentation

What problem does it solve?

This Skill helps you identify the root cause of performance issues (CPU, graphics, I/O, IPC, memory, and power problems) inside an Android Perfetto trace by building a verified chain of evidence rather than relying on guesses.

Core Features & Use Cases

  • Evidence-based investigation workflow: Creates a per-trace scratchpad to record verified facts only, then iteratively forms hypotheses, collects data, and drills down with strict evidentiary rigor.
  • Domain-hints-driven profiling: Uses expert-vetted techniques across CPU scheduling, graphics rendering/memory, I/O stalls, binder/IPC patterns, memory pressure, and battery-related rails/wakelocks.
  • Perfetto SQL generation with guardrails: Follows the provided SQL execution protocol, including correct handling of incomplete slice durations (dur = -1), safe joins via UTID/UPID, and mandatory use of GLOB for matching.
  • Broad-to-narrow trace strategy: Starts with high-level metrics, then narrows with targeted queries; includes startup/package discovery when the request is broad.

Quick Start

Use the perfetto-trace-analysis skill to analyze the attached Perfetto trace and produce a verified root-cause report for the slow performance you observe.

Dependency Matrix

Required Modules

None required

Components

references

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: https://developer.android.com/agents/skills/profilers/perfetto-trace-analysis/skill
Download link: https://github.com/fornewid/android-developers-changelog/archive/main.zip#https-developer-android-com-agents-skills-profilers-perfetto-trace-analysis-skill

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.