perf-nsight-compute-analysis

Analyze Nsight Compute .ncu-rep reports to classify CUDA kernel bottlenecks.

2.8k|332|Updated Feb 25, 2026
One-click install
npx skills add https://github.com/NVIDIA/skills --skill perf-nsight-compute-analysis
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: perf-nsight-compute-analysis
Source: https://github.com/NVIDIA/skills/tree/main/skills/TensorRT-LLM/perf-nsight-compute-analysis
Command: npx skills add https://github.com/NVIDIA/skills --skill perf-nsight-compute-analysis

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Analyze Nsight Compute profiling outputs to diagnose CUDA kernel bottlenecks.

Core Features & Use Cases

  • SOL% based bottleneck classification to identify compute-bound, memory-bound, or latency-bound kernels.
  • Roofline and memory-hierarchy analysis to guide optimization priorities.
  • Section-guided deep dives (SpeedOfLight, ComputeWorkloadAnalysis, MemoryWorkloadAnalysis) on .ncu-rep reports.
  • Reproducible guidance for profiling workflows across Nsight Compute versions and GPU architectures.

Quick Start

Profile a kernel with Nsight Compute to quickly identify bottlenecks and recommended next steps.

Frequently Asked Questions about perf-nsight-compute-analysis

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

FAQPage Schema
How do I identify CUDA kernel bottlenecks from an Nsight Compute report?

To identify CUDA kernel bottlenecks from an Nsight Compute report, the Skill analyzes .ncu-rep files using SOL% classification to determine if kernels are compute-bound, memory-bound, or latency-bound.

What is SOL% based bottleneck classification in GPU profiling?

SOL% based bottleneck classification in GPU profiling measures the speed of light to identify whether a CUDA kernel is compute-bound, memory-bound, or latency-bound, guiding subsequent optimization priorities.

How do I use roofline analysis to guide CUDA kernel optimization?

Roofline analysis guides CUDA kernel optimization by mapping workload data against hardware limits in the .ncu-rep report, pinpointing whether memory bandwidth or compute throughput restricts performance.

Do I need .ncu-rep files to analyze kernel performance with this workflow?

Yes, you need .ncu-rep files generated by Nsight Compute to analyze kernel performance, as these reports contain the required SpeedOfLight and workload analysis sections for consistent results.

What sections should I deep dive into for memory workload analysis?

For memory workload analysis, you should deep dive into the MemoryWorkloadAnalysis and ComputeWorkloadAnalysis sections of the .ncu-rep report to diagnose memory hierarchy bottlenecks.

Does this profiling workflow support different GPU architectures?

Yes, this profiling workflow supports different GPU architectures by providing reproducible guidance for analyzing Nsight Compute profiling outputs across various versions and hardware architectures.