perf

Analyze Linux CPU hotspots and call stacks with the perf profiling tool suite.

6|1|Updated Feb 16, 2026
One-click install
npx skills add https://github.com/L3DigitalNet/Claude-Code-Plugins --skill perf-l3digitalnet
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: perf
Source: https://github.com/L3DigitalNet/Claude-Code-Plugins/tree/main/plugins/linux-sysadmin/skills/perf
Command: npx skills add https://github.com/L3DigitalNet/Claude-Code-Plugins --skill perf-l3digitalnet

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps identify and diagnose performance bottlenecks and inefficiencies within the Linux kernel and applications, leading to faster and more optimized systems.

Core Features & Use Cases

  • CPU Hotspot Identification: Pinpoint functions consuming the most CPU time using perf top.
  • Performance Event Counting: Measure hardware and software events like cycles, instructions, and cache misses with perf stat.
  • Call Graph Profiling: Record and analyze detailed call stacks to understand execution flow and identify deep-rooted issues using perf record and perf report.
  • Use Case: When an application is running slower than expected, use perf record -g to capture a profile, then perf report to visualize the call stacks and identify the specific functions causing the slowdown.

Quick Start

Use the perf skill to get a live top-like view of CPU hotspots on your system.

Frequently Asked Questions about perf

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

FAQPage Schema
How do I identify CPU hotspots in a Linux application?

To identify CPU hotspots in a Linux application, use the perf profiling tool to capture a live top-like view of functions consuming the most CPU time. This pinpoints specific functions causing execution slowdowns.

How do I measure hardware events like cache misses on Linux?

To measure hardware events like cache misses on Linux, use the perf stat command. It counts hardware and software events including cycles and instructions to help diagnose system performance inefficiencies.

What is the best way to analyze call stacks for a slow Linux program?

The best way to analyze call stacks for a slow Linux program is using `perf record -g` to capture a profile, then `perf report` to visualize execution flow and identify deep-rooted bottleneck functions.

Do I need kernel debug symbols for Linux performance profiling?

Yes, you need kernel debug symbols for full call stack resolution during Linux performance profiling. The perf tool suite also requires the linux-perf package to be installed on your system beforehand.

What limitations exist when using perf for bottleneck diagnosis?

A key limitation of using perf for bottleneck diagnosis is that full call stack resolution may be incomplete without kernel debug symbols installed. The suite also strictly requires the linux-perf package to function.