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.