Android Profiler

by android42dc2270e960Complete terms in LICENSE.txt7.7K starsListed Oct 8, 2026Updated Oct 8, 2026Repository updated 13 days ago

Manages Android performance profiling and debugging. Triggers when the user asks to record or analyze Android performance data, such as system traces, heap dumps, method recordings, callstack samples, memory allocations, or investigate bottlenecks, jank, memory leaks, and app startup issues on Android, or when the user asks to write, debug, or execute ad-hoc SQL queries. Applies to both user and system apps or services.

AI-generated overview

Guides Android performance profiling: recording system traces, heap dumps and method recordings, and analyzing them with Perfetto SQL.

What it does
This skill orchestrates Android performance profiling and debugging work. It disambiguates the user's intent, routes recording requests through a recording orchestrator that covers pre-flight and dependency checks, and routes analysis requests through an analysis orchestrator. Analysis workflows use Perfetto trace analysis and SQL, with subsystem hints for CPU, graphics, I/O, IPC, memory and power, plus example trace configs for jank, CPU profiling, heap dumps and memory counters.
When to use it
Use it when someone wants to record or analyze Android performance data such as system traces, heap dumps, method recordings, callstack samples or memory allocations. It also fits investigations of bottlenecks, jank, memory leaks and app startup issues on Android, including ad-hoc SQL queries over traces.
Requirements
Instructions only; no scripts are shipped. It expects a skill root path to be set per its environment setup reference, and relies on bundled Perfetto trace_processor and reference documents. Recording and analysis of a device or trace require the corresponding Android tooling and access to the target app or device.

Android Profiler Orchestrator

Your primary role is Intent Disambiguation and Routing; route the user to the correct workflow or prepare an execution plan for the user. Work with the user to finalize the plan and then proceed with the plan execution, addressing singular as well as composite needs.

Prerequisites and Setup

Before executing any workflows, read references/env_setup.md [blocked] (it sits next to this file in the skill root). It defines what to set $SKILL_ROOT to - the anchor every other path in this skill is written against.

Intent Disambiguation

Do not guess the user's intent. If the user request is not clear, ask the user what they want to do before proceeding.

Recording

Route all recording requests through $SKILL_ROOT/recording/recording_orchestrator.md. This defines guidelines and pre-flight checks or dependency checks that apply to all recording workflows, and ensures you have the necessary setup to proceed. Read the orchestrator and execute the plan it describes based on what the user wants to record (for example, a system trace or a heap dump).

Analysis

Route all analysis requests through $SKILL_ROOT/analysis/analysis_orchestrator.md.

Source and attribution

Source:android/skillsinprofilers/android-profilerat commit42dc227

License: Complete terms in LICENSE.txt

Content belongs to its original authors. SourceWeft indexes it from a public repository.

Report or request removal

More from android/skills

Wear Compose M3

android

Guides building, updating and migrating Wear OS Compose Material3 apps, with canonical component samples and version rules.

Software Development7.7Kupdated 13 days ago

Display Glasses With Jetpack Compose Glimmer

android

Provides guidelines for developing projected Android XR apps for display glasses using the Jetpack Compose Glimmer UI toolkit. This skill covers foundational Glimmer design principles, workflows for implementing Jetpack Compose Glimmer, and interaction models for the glasses form factor. Use this skill to build an Android XR Augmented Experience app with Jetpack Compose Glimmer that adheres to the Glimmer design system for optimized glasses styling.

Awaiting classification7.7Kupdated 13 days ago

Play Billing Library Version Upgrade

android

Guides upgrading an Android project from a legacy Google Play Billing Library version to the latest stable release.

Software Development7.7Kupdated 13 days ago

Leanback To Compose Tv Migration

android

Provides instructions and architectural patterns for migrating Android TV applications from legacy Leanback UI Toolkit, Android Views, or Support Fragments to Jetpack Compose for TV (androidx.tv). Use this skill for Leanback to Compose migrations, including browse screen, settings screen, authentication screen, login screen, or video playback screen migrations, or when replacing BrowseSupportFragment, LeanbackSettingsFragment, PreferenceFragment, BaseLeanbackPreferenceFragmentCompat, VideoSupportFragment, GuidedStepSupportFragment, SearchSupportFragment, VerticalGridSupportFragment, Presenter, ArrayObjectAdapter, or CursorMapper with modern Compose equivalents, implementing immersive carousels with focus memory, Media3 video playback with PlayerSurface, or custom 10-foot hero layouts.

Awaiting classification7.7Kupdated 13 days ago

Testing Setup

android

Analyzes an Android project's testing setup and installs testing frameworks, harnesses and tests for unit, UI, screenshot and end-to-end coverage.

Software Development7.7Kupdated 13 days ago

Styles

android

Guides migrating Android Jetpack Compose custom components and themes to the experimental Styles API.

Software Development7.7Kupdated 13 days ago