Skip to content
Get packs

Android Profiler

Records and analyzes Android performance traces to diagnose jank, memory, CPU, power and IPC issues

Source Download skill
Repository
android/skills
Stars
10,278
Licence
Apache-2.0
Files
15 files

What it does

This skill teaches an AI agent to help diagnose Android performance problems. It can guide recording of system traces, CPU call stacks, GPU memory or heap profiles, and then analyze Perfetto trace files for issues such as UI jank, ANRs, slow app startup, Binder/IPC storms, battery drain, and memory pressure or leaks. It also covers A/B trace comparisons and ad hoc PerfettoSQL queries.

Great for

  • Android app developers investigating jank, slow startup or ANRs
  • Platform or performance engineers comparing a baseline trace against a regression
  • Developers who want help writing PerfettoSQL queries against an existing trace

Skip it if

  • Users without access to a device or existing trace files, since most workflows need recorded data
  • Anyone expecting it to fix code automatically; it diagnoses and reports rather than changing an app
  • Sensitive production devices: recording traces can capture app and system activity, so use test devices or get consent

Try asking

  • “Record a system trace while my app scrolls a list and find the cause of the dropped frames”
  • “Analyze this Perfetto trace file for ANRs and main thread blocking”
  • “Compare these two traces and tell me whether startup regressed”
  • “Write a PerfettoSQL query to list the longest Binder transactions in this trace”
Step-by-step guide: how to use Android ProfilerInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 15 original files, the Apache-2.0 licence and an attribution note.

    android-profiler.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip android-profiler.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip android-profiler.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Describe the symptom precisely (for example, scrolling jank in one screen) so the agent picks the right workflow and hints
  • Keep a baseline trace from before the change so A/B comparisons are meaningful
  • Review any commands the agent proposes to run on your device before approving them

What's inside

  • analysis/analysis_orchestrator.md
  • analysis/workflows/perfetto-sql/perfetto_sql.md
  • analysis/workflows/perfetto-trace-analysis/perfetto_trace_analysis.md
  • analysis/workflows/perfetto-trace-analysis/references/hints/hints_cpu.md
  • analysis/workflows/perfetto-trace-analysis/references/hints/hints_graphics.md
  • analysis/workflows/perfetto-trace-analysis/references/hints/hints_io.md
  • analysis/workflows/perfetto-trace-analysis/references/hints/hints_ipc.md
  • analysis/workflows/perfetto-trace-analysis/references/hints/hints_memory.md
  • analysis/workflows/perfetto-trace-analysis/references/hints/hints_power.md
  • analysis/workflows/perfetto-trace-analysis/references/per_candidate_analysis.md
  • analysis/workflows/perfetto-trace-analysis/references/triage.md
  • recording/recording_orchestrator.md
  • recording/workflows/perfetto-trace-recording/perfetto_trace_recording.md
  • recording/workflows/perfetto-trace-recording/references/trace_config_reference.md
  • SKILL.md

Redistributed unmodified from android/skills under the Apache-2.0 licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.