performance-profiling

Diagnose and fix slow system performance by measuring latency, throughput, and memory.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/ohsonerdy/openclaw-frontier-stack --skill performance-profiling-ohsonerdy
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: performance-profiling
Source: https://github.com/ohsonerdy/openclaw-frontier-stack/tree/main/skills/performance-profiling
Command: npx skills add https://github.com/ohsonerdy/openclaw-frontier-stack --skill performance-profiling-ohsonerdy

SYSTEM DOCUMENTATION & REQUIREMENTS

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.

Frequently Asked Questions about performance-profiling

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find the real performance bottleneck when an endpoint is slow?▼

To find the real performance bottleneck, you must first define an explicit optimization target like p99 latency or throughput, establish a baseline measurement, and then use the correct profiler to classify the root cause before applying targeted changes.

What is the best way to profile CPU vs I/O blocking issues?▼

The best way to profile CPU vs I/O blocking issues is through profiler selection by symptom, matching the specific technique to the scenario—using CPU profilers for compute-bound work and wall-clock or distributed tracing for blocking I/O latency.

How do I fix N+1 database queries causing high latency?▼

To fix N+1 database queries causing high latency, classify the bottleneck through database query profiling, apply the smallest effective targeted change to the query pattern, and re-verify the improvement against the original baseline metrics.

When do I need distributed tracing for cross-service latency?▼

You need distributed tracing for cross-service latency when diagnosing slow performance across multiple services, as it measures the wall-clock time and blocking delays across network boundaries that standard CPU profilers cannot capture.

How do I verify performance improvements after optimizing code?▼

To verify performance improvements after optimizing code, re-measure using the exact same workload and metric from your initial baseline capture, stopping only when you hit the explicit target or when returns diminish.

Why does optimization work stop before fixing all slow code?▼

Optimization work stops before fixing all slow code because baseline-driven optimization applies Amdahl's Law to avoid chasing irrelevant code, halting once the explicit goal is met or returns diminish.