linux-perf-profile

Profile Linux performance on ARM Graviton3 systems using the perf tool.

2|Updated Jan 24, 2026
One-click install
npx skills add https://github.com/ahrav/scratch-scanner-rs --skill linux-perf-profile
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: linux-perf-profile
Source: https://github.com/ahrav/scratch-scanner-rs/tree/main/.claude/skills/linux-perf-profile
Command: npx skills add https://github.com/ahrav/scratch-scanner-rs --skill linux-perf-profile

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides in-depth hardware-level performance analysis for Linux applications, helping to diagnose and resolve performance bottlenecks that are not apparent from standard benchmarks.

Core Features & Use Cases

  • Microarchitectural Analysis: Utilizes PMU counters, topdown analysis, and cache/TLB metrics to pinpoint performance issues at the CPU level.
  • Hotspot Identification: Generates flamegraphs and annotated disassembly to visualize and drill down into performance-critical code sections.
  • Use Case: After identifying a performance regression with a benchmarking tool, use this Skill to understand why a specific function is slower by examining its cache miss rates, branch mispredictions, and instruction retirement bottlenecks.

Quick Start

Run a topdown overview profiling of the scanner-rs application on the linux directory.

Frequently Asked Questions about linux-perf-profile

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

FAQPage Schema
How do I identify CPU performance bottlenecks on ARM Graviton3 using Linux perf?

To identify CPU performance bottlenecks on ARM Graviton3, Linux perf profiling analyzes PMU counters, topdown decomposition, and cache behavior. It pinpoints microarchitectural issues by examining instruction retirement bottlenecks and annotated disassembly.

What causes high cache miss rates and branch mispredictions in my Linux application?

High cache miss rates and branch mispredictions are diagnosed by examining PMU counters and TLB metrics during Linux perf profiling. This deep hardware-level analysis reveals why specific functions execute slower than expected under standard benchmarks.

Can I use Linux perf to do a topdown analysis on ARM systems?

Yes, you can use Linux perf to perform topdown analysis on ARM Graviton3 systems. This process utilizes PMU counters to break down CPU execution stalls, helping pinpoint exactly where instruction retirement bottlenecks occur within your code.

How do I profile a performance regression and compare builds with Linux perf?

To profile a performance regression and compare builds, Linux perf supports A/B comparisons of build regressions. It generates flamegraphs and annotated disassembly to visualize and drill down into performance-critical code sections.

Does Linux perf profiling work for analyzing annotated disassembly on Graviton3?

Linux perf profiling works for analyzing annotated disassembly on Graviton3 by mapping hardware metrics directly to source lines. This per-line cost analysis reveals exact cache miss rates and branch mispredictions within performance-critical code sections.