Android Profiler
Organizationandroid
Records and analyzes Android performance data and diagnoses performance bottlenecks across user apps, system apps, and system services, even if the user does not explicitly mention profiling or traces. Use when: recording system traces, CPU call stacks, Vulkan GPU/DRM memory, or Java/native heap profiles; analyzing Perfetto traces for UI jank, frame drops, ANRs, or app startup latency issues; investigating CPU bottlenecks, IPC/Binder storms, or thread scheduling stalls; diagnosing battery drain, modem power rails, and kernel wake locks; debugging memory pressure, Low Memory Kills (LMK), OOMs, leaks, and allocation churn; performing A/B baseline trace comparisons to find regressions; executing ad hoc PerfettoSQL queries on Android traces.
Overview
- Repository
- android/skills
- Publisher
- android
- Stars
- 10.5K
- Forks
- 695
- Bundled files
- 25
- License
- Apache-2.0
- Updated
- Nov 11, 2026
Installation
tmp=$(mktemp -d)
git clone --depth 1 https://github.com/android/skills.git "$tmp"
mkdir -p ~/.claude/skills
cp -R "$tmp/profilers/android-profiler" ~/.claude/skills/android-profiler
rm -rf "$tmp"tmp=$(mktemp -d)
git clone --depth 1 https://github.com/android/skills.git "$tmp"
mkdir -p ~/.codex/skills
cp -R "$tmp/profilers/android-profiler" ~/.codex/skills/android-profiler
rm -rf "$tmp"Install the Android Profiler agent skill from https://github.com/android/skills/tree/main/profilers/android-profiler into this project's skills folder.Instructions
Your primary role is to figure out what the user wants to do (disambiguation), find the right instructions for it (workflow discovery), and follow them step-by-step (following the execution plan). If the request is unclear, work with the user to finalize the execution plan before proceeding.
Prerequisites and Setup
Before executing any workflows, read references/env_setup.md. 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 recording/recording_orchestrator. 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 analysis/analysis_orchestrator.
Bundled files
analysis/analysis_orchestrator.md2 KBanalysis/workflows/perfetto-sql/perfetto_sql.md969 Banalysis/workflows/perfetto-trace-analysis/perfetto_trace_analysis.md5 KBanalysis/workflows/perfetto-trace-analysis/references/hints/hints_cpu.md3 KBanalysis/workflows/perfetto-trace-analysis/references/hints/hints_graphics.md3 KBanalysis/workflows/perfetto-trace-analysis/references/hints/hints_io.md2 KBanalysis/workflows/perfetto-trace-analysis/references/hints/hints_ipc.md2 KBanalysis/workflows/perfetto-trace-analysis/references/hints/hints_memory.md3 KBanalysis/workflows/perfetto-trace-analysis/references/hints/hints_power.md2 KBanalysis/workflows/perfetto-trace-analysis/references/per_candidate_analysis.md9 KBanalysis/workflows/perfetto-trace-analysis/references/triage.md4 KBrecording/recording_orchestrator.md2 KBrecording/workflows/perfetto-trace-recording/perfetto_trace_recording.md5 KBrecording/workflows/perfetto-trace-recording/references/example-configs/app_jank.pftxt2 KBrecording/workflows/perfetto-trace-recording/references/example-configs/cpu_profile.pftxt773 Brecording/workflows/perfetto-trace-recording/references/example-configs/java_heap_dump.pftxt566 Brecording/workflows/perfetto-trace-recording/references/example-configs/long_background.pftxt1006 Brecording/workflows/perfetto-trace-recording/references/example-configs/memory_counters.pftxt2 KBrecording/workflows/perfetto-trace-recording/references/example-configs/native_heap.pftxt589 Brecording/workflows/perfetto-trace-recording/references/example-configs/sched_cpu.pftxt836 Brecording/workflows/perfetto-trace-recording/references/trace_config_reference.md5 KBreferences/env_setup.md513 Breferences/perfetto/bin/trace_processor11 KBreferences/perfetto/setup.md2 KBreferences/perfetto/sql.md16 KB
FAQ
What does Android Profiler do?
Records and analyzes Android performance data and diagnoses performance bottlenecks across user apps, system apps, and system services, even if the user does not explicitly mention profiling or traces. Use when: recording system traces, CPU call stacks, Vulkan GPU/DRM memory, or Java/native heap profiles; analyzing Perfetto traces for UI jank, frame drops, ANRs, or app startup latency issues; investigating CPU bottlenecks, IPC/Binder storms, or thread scheduling stalls; diagnosing battery drain, modem power rails, and kernel wake locks; debugging memory pressure, Low Memory Kills (LMK), OOMs, leaks, and allocation churn; performing A/B baseline trace comparisons to find regressions; executing ad hoc PerfettoSQL queries on Android traces.
Who made Android Profiler?
android (an organization) publishes it in the android/skills repository on GitHub.
Is Android Profiler free?
Yes. Android Profiler is open source, published by android under the Apache-2.0 license.
What comes with Android Profiler?
Its instructions and 25 files the agent reads only when a task needs them, such as references, examples or scripts.
Which agents can use Android Profiler?
Any coding agent that reads SKILL.md files, including Claude Code, Codex, Cursor, GitHub Copilot and Gemini CLI. The agent loads the skill when a task matches its description.
What are agent skills?
An agent skill is a folder with a SKILL.md file: instructions that teach a coding agent how to do one kind of task, and optionally files it can read while it works. The agent keeps only the skill's name and description in mind and reads the rest when a task calls for it.
How are agent skills different from MCP servers?
An MCP server gives an agent new tools to call, code that runs somewhere and returns results. A skill gives it knowledge: how to approach a task with the tools it already has. Many agents use both.
How can my agent test my Android app?
Robomori lets coding agents create, start and control Android emulators and devices from one command, so they can install your app, take screenshots and check dark mode, font sizes and languages.
Audits Android codebases for ANR risks and diagnoses ANR stack dumps. Use this skill when scanning Android code for ANR risks or triaging ANR stack dumps. Don't use for non-ANR crashes, dropped frames, general CPU profiling, or Perfetto system traces.
Diagnose and optimize Android Jetpack Compose UI code. Use this skill when analyzing performance bottlenecks of existing code to minimize recomposition overhead and prevent dropped frames and UI lag.
Analyzes Android build files and R8 keep rules to identify redundancies, broad package-wide rules, and rules that subsume library consumer keep rules. Use this skill when developers want to optimize their Android app's size, remove redundant or overly broad keep rules, or troubleshoot ProGuard configurations. Don't use for general Gradle build errors, Compose UI performance, or runtime CPU profiling.
Use when comparing physical Android benchmark configurations, investigating inconsistent rankings, or selecting an Android default from measured results. Do not use for code-level Compose performance diagnosis without a configuration comparison.
