gpu-kernel-bottleneck-analysis

Analyzes GPU kernel performance using Roofline models and profiling data.

71|22|Updated Jun 23, 2026
One-click install
npx skills add https://github.com/alibaba/atrex-kernel-agent --skill gpu-kernel-bottleneck-analysis
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gpu-kernel-bottleneck-analysis
Source: https://github.com/alibaba/atrex-kernel-agent/tree/main/skills/gpu-kernel-bottleneck-analysis
Command: npx skills add https://github.com/alibaba/atrex-kernel-agent --skill gpu-kernel-bottleneck-analysis

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This skill addresses the difficulty of identifying performance bottlenecks in GPU kernels by providing a structured, evidence-based diagnostic framework that moves beyond guesswork.

Core Features & Use Cases

  • Roofline Analysis: Calculate compute and memory utilization against theoretical hardware peaks.
  • Evidence-Based Diagnosis: Extract concrete metrics from profiling tools like NCU or ROCprof to pinpoint stalls, bank conflicts, or low occupancy.
  • Use Case: When a custom CUDA kernel underperforms, use this skill to determine if it is memory-bound or compute-bound and identify the specific ISA-level bottleneck preventing higher throughput.

Quick Start

Use the gpu-kernel-bottleneck-analysis skill to profile the current kernel and generate a report identifying the primary performance bottleneck.

Frequently Asked Questions about gpu-kernel-bottleneck-analysis

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

FAQPage Schema
How do I diagnose if my CUDA kernel is compute-bound or memory-bound?▼

To diagnose if a CUDA kernel is compute-bound or memory-bound, calculate its TFLOPS and bandwidth utilization against a hardware-specific Roofline model. This skill extracts concrete metrics from NVIDIA NCU profiling data to pinpoint the specific bottleneck.

What is GPU Roofline analysis and how does it identify performance stalls?▼

GPU Roofline analysis is a diagnostic framework that measures compute and memory utilization against theoretical hardware peaks. By parsing profiling summaries, it identifies specific ISA-level stalls, bank conflicts, or low occupancy preventing higher throughput.

Can I use this to profile AMD ROCprof data for kernel underperformance?▼

Yes, you can profile AMD ROCprof data to identify kernel underperformance. The analysis supports diagnostic workflows for both compute-bound and memory-bound kernels by parsing ROCprofiling summary files to extract actionable optimization evidence.

How do I find ISA-level bottlenecks preventing higher GPU kernel throughput?▼

To find ISA-level bottlenecks, execute the provided Python benchmarking tools to generate profiling data, then parse the summary files. This evidence-based approach moves beyond guesswork to pinpoint exact stalls or low occupancy issues.

Do I need to run Python benchmarking tools before analyzing GPU kernel performance?▼

Yes, you need to run Python benchmarking tools to generate the profiling summary files required for analysis. The skill parses these extracted metrics to determine if the kernel is memory-bound or compute-bound against the hardware Roofline.