Perfetto Android Skills — Development skill for Claude Code
Agent skill: measure, diagnose, fix and re-measure Android app performance from a Perfetto trace.
How to install Perfetto Android Skills
This entry records only its repository, not the path inside it, so there is no
exact command to give. Open aldefy/perfetto-android-skills and copy the folder into
~/.claude/skills/, or the file into ~/.claude/agents/.
What Perfetto Android Skills does
Agent skill: measure, diagnose, fix and re-measure Android app performance from a Perfetto trace.
Alternatives in Development
- Skill Creator — Create new skills, modify existing skills, and measure skill performance 94.1k ★
- Fidelity — Measure how faithfully a clone reproduces a site — pixel-diff plus motion-fidelity into one 0-100 score, a let 3.6k ★
- Investigate Performance — Investigate a Nimbalyst performance problem (freeze, lag, idle CPU, slow op, memory growth) with measured evid 1.6k ★
README
perfetto-android-skills
An agent skill that turns "the app feels slow" into a ranked, evidence-backed list of causes, then a fix, then a re-measurement that proves the fix worked.
This isn't a wrapper around Perfetto's UI. It's a checklist a senior Android performance engineer already runs by hand, encoded so an agent (or you) can run it the same way every time: capture a real trace, ask the same four questions in the same order, rank findings by *self* time, map slice names back to files in your repo, then measure again after the fix.
Built for [BLR Droid](https://trace-to-triage.pages.dev), a talk on reading Perfetto traces and automating that reading.
What's inside
perfetto-triage/
SKILL.md the method: four questions, six workflow steps, hard rules
scripts/
capture.sh pulls a real trace off a connected device (cold-start or interactive)
triage.py parses a trace once, runs the query pack, writes a ranked report
remeasure.py diffs two triage-out directories: findings, jank numbers, self-time hotspots
ab_startup.sh adb-only before/after harness when a benchmark module is out of scope
queries/ 18 PerfettoSQL files, 00_health.sql through 41_anrs.sql
references/
reading-a-trace.md the human mental model: what a track/slice/timeline actually means
sql-cookbook.md PerfettoSQL schema and idioms for questions the query pack doesn't cover
capture.md capture troubleshooting, non-default configs
benchmark-setup.md adding Macrobenchmark + Baseline Profiles to a brownfield app
fixes.md finding-class to concrete fix to expected size
cross-platform.md Flutter, React Native, Unity, WebView: same pipeline underneath
assets/
startup_jank.pbtxt the real trace config capture.sh pushes to the device
The four questions
Every findi
Related Skills
Buzz
Profile Lean declarations, find the slow ones, trace-diagnose the root cause, and fix them until each elaborat
Perfetto MCP Rs
Perfetto trace analysis via MCP — PerfettoSQL queries plus dedicated Chrome tools for scroll jank, page loads,
Clens
Claude Code session capture and analysis. Trace tool calls, detect backtracks, analyze decisions, track edit c
Bobby Performance
Performance benchmarking — measure and detect regressions
Pbi Explain
Deconstruct any DAX measure into a structured plain-English breakdown covering business logic, filter context
Pbi Optimise
Run a 14-rule performance scan on any DAX measure, identifying anti-patterns like unnecessary iterators, FILTE
Related Agents
Alfresco Debugger Agent
Given an Alfresco stack trace or log snippet, searches documentation and known issues to diagnose the root cau
Shopify Debugger
Use when a Shopify app fails (CLI error, auth loop, webhook 401, function panic, missing scope, billing reject
Android Pro
Expert in Android development, specializing in modern Android practices, optimizing performance, and ensuring