What problem does it solve?
It turns vague performance complaints into an evidence-based process for identifying the true bottleneck and applying the smallest effective change, then verifying the improvement with fresh measurements.
Core Features & Use Cases
- Goal-first profiling: defines the optimization target (latency median vs p95/p99, throughput, memory, cold-start, or cost) so work stops when success is real.
- Profiler selection by symptom: chooses the right technique for CPU vs allocation vs blocking/wall-clock vs distributed tracing vs database query slowness.
- Baseline-driven optimization: establishes a baseline measurement and uses Amdahl’s Law to avoid chasing irrelevant “looks slow” code.
- Bottleneck classification and fix shape: maps common causes (N+1 queries, blocking I/O, lock contention, GC pressure, serialization overhead, allocation hot loops, cache misses, cold paths becoming hot) to concrete next actions.
- Verification and stopping discipline: re-measures using the same workload and metric, then stops at the target or when returns diminish.
Quick Start
Use the performance-profiling skill when someone reports “this endpoint is slow” and ask it to measure the right metric with the correct profiler, establish a baseline, classify the bottleneck, propose a targeted fix, and produce a verification plan.