ncu-report-skill

Profile CUDA kernels with Nsight Compute and generate optimization reports for Blackwell B200 GPUs.

177|27|Updated Apr 13, 2026
One-click install
npx skills add https://github.com/mit-han-lab/ncu-report-skill --skill ncu-report-skill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ncu-report-skill
Source: https://github.com/mit-han-lab/ncu-report-skill/tree/main
Command: npx skills add https://github.com/mit-han-lab/ncu-report-skill --skill ncu-report-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires ncu_report.

What problem does it solve?

Profile CUDA kernels with Nsight Compute on NVIDIA Blackwell B200 to identify bottlenecks, reason about root causes, and generate a structured optimization plan.

Core Features & Use Cases

  • End-to-end profiling workflow: harness creation, gathering reports, and reporting.
  • Python-based analysis: extract metrics, compare runs, and map signals to fixes.
  • Six analysis dimensions and a diagnosis playbook to guide actionable changes.
  • Final optimization report with prioritized recommendations and evidence.

Quick Start

Create a new run directory under profile/<run_name>/, build a standalone harness with -lineinfo, and profile the kernel with Nsight Compute.

Frequently Asked Questions about ncu-report-skill

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

FAQPage Schema
How do I profile CUDA kernels to diagnose performance bottlenecks?

To profile CUDA kernels, you use Nsight Compute to collect metrics and diagnose bottlenecks. This generates an evidence-backed optimization report with prioritized recommendations for fixing identified performance issues.

What's the best way to generate a GPU kernel optimization plan for Blackwell B200?

Generating a GPU kernel optimization plan for Blackwell B200 involves profiling with Nsight Compute to extract metrics. The profiling results map signals to actionable fixes across six analysis dimensions to guide your changes.

Do I need the ncu_report Python module to analyze Nsight Compute reports?

Yes, you need the ncu_report Python module to parse and compare Nsight Compute reports. It enables Python-based analysis to extract metrics from profiling runs and map those signals to concrete optimization fixes.

How do I start an end-to-end profiling workflow for CUDA kernels?

To start an end-to-end profiling workflow, create a new run directory under profile/<run_name>/ and build a standalone harness with -lineinfo. You then profile the kernel with Nsight Compute to gather reports for analysis.

Can I compare Nsight Compute profiling runs to identify kernel regression?

Yes, you can compare Nsight Compute profiling runs using the ncu_report module to identify kernel regressions. This Python-based analysis extracts metrics from different runs to map performance signals to required fixes.