mcpField
A
android-profiler

android-profiler

github.com/androidDevelopment10.0k1.1k installsUpdated 2d ago
Repository

About android-profiler

A skill for organizing Android profiling and analysis tasks through intent clarification, workflow discovery, and stepwise execution. It requires reading environment setup first and routes recording and analysis requests through separate orchestrators.

Key features

  1. 01Clarify user intent first
  2. 02Discover workflows for each task
  3. 03Route recording through its orchestrator
  4. 04Route analysis through its orchestrator
  5. 05Read environment setup before execution

Use cases

  1. 01Clarify ambiguous analysis or recording requests
  2. 02Record a system trace or heap dump through the workflow
  3. 03Select the appropriate steps for an analysis task

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/android/skills --skill android-profiler

After installing, type/android-profilerin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

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/
per_candidate_analysis.md
triage.md
analysis/workflows/perfetto-trace-analysis/references/hints/
hints_cpu.md
hints_graphics.md
hints_io.md
hints_ipc.md
hints_memory.md
hints_power.md
recording/
recording_orchestrator.md
recording/workflows/perfetto-trace-recording/
perfetto_trace_recording.md
recording/workflows/perfetto-trace-recording/references/
trace_config_reference.md
recording/workflows/perfetto-trace-recording/references/example-configs/
app_jank.pftxt
cpu_profile.pftxt
java_heap_dump.pftxt
long_background.pftxt
memory_counters.pftxt
native_heap.pftxt
sched_cpu.pftxt
references/
env_setup.md
references/perfetto/
setup.md
sql.md
references/perfetto/bin/
trace_processor

Details

From the project README

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.

Comments

Markdown supported