Individual skill

rocprofiler-pc-sampling

Profiles a target application using rocprofv3 with program counter sampling enabled and then analyzes the results. Use when the user has a program that runs on an AMD GPU and asks to perform PC sampling, to determine the runtime performance characteristics of their application, to determine stall reasons, or to determine hotspots in the code.

skills/rocprofiler-pc-sampling/SKILL.md

Read pinned source

Source commit e6ee0b7c2e78babc7c7240b34f3fea0a6f510a65

What was checked

Matches the observed repository HEAD: Yes
Scanner rules are current: No
Repository scan complete: No
Skill scan complete: No
Observed behavior: Not checked yet
Last checked: Nov 6, 2026

These are observations at the recorded commit, not a guarantee of safety. Review the source before running it.

Install this skill

Choose an agent in your Stack or copy a command below. Commands fetch the pinned commit and copy only this skill directory. Existing destinations are refused. Copying a command does not install anything.

An install command is unavailable: current rules, complete repository and skill scans, an eligible behavior level and a permitted license are required.

Repository context

Repository stars (not skill ratings): 483
Repository last updated: Nov 8, 2026
License: MIT

Observed agent integration: No specific integration evidence. Standard SKILL.md installation does not imply verified compatibility.

engineering Derived category

Files and excerpt

File metadata and permitted, redacted excerpts come from the recorded scan. Source links are pinned to that commit.

Browse files

.federated.jsonasset · 347 bytes
SKILL.mdcore · 6,492 bytes
SKILL.mdcore · 6,492 bytes
SKILL.mdcore · 6,492 bytes
SKILL.mdcore · 6,492 bytes
SKILL.mdcore · 6,492 bytes
evals/evals.jsonasset · 1,901 bytes
evals/machine.ymlasset · 41 bytes
evals/resources/myCudaProgram.cuasset · 7,141 bytes
evals/resources/myHipProgram.hip.cppasset · 7,108 bytes
resources/stall-reasons.mddoc · 3,659 bytes
scripts/analyze_pc_sampling.pyruns · 20,448 bytes
skill-card.mddoc · 254 bytes
tests/test_analyze_pc_sampling.pyruns · 8,000 bytes

Read excerpt


# PC Sampling

## Prerequisites

- The system must have a ROCm installation and an accessible AMD GPU; that is, `amd-smi` should return at least one valid device.
- The GPU must support PC sampling. Available PC sampling configurations can be determined via `rocprofv3-avail info --pc-sampling` or `rocprofv3 -L`. Your sampling method and interval must align with the outputs of this command. Also pay attention to any flags reported for a given configuration; at time of writing, stochastic sampling intervals must be powers of two.
- The application should be built with debug symbols AND optimization flags (e.g. `-g -O3`) in order to get source line attribution and a representative execution profile.

## How to use PC Sampling

To run rocprofv3 with PC sampling:

- explicitly enable pc sampling with the flag `--pc-sampling-beta-enabled`.
- specify the pc sampling method with `--pc-sampling-method`: `host_trap` or `stochastic`