nsys-ai

Analyze NVIDIA Nsight Systems profiles to identify GPU bottlenecks and propose fixes.

71|20|Updated Feb 26, 2026
One-click install
npx skills add https://github.com/GindaChen/nsys-ai --skill nsys-ai
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: nsys-ai
Source: https://github.com/GindaChen/nsys-ai/tree/main/skills/analyze
Command: npx skills add https://github.com/GindaChen/nsys-ai --skill nsys-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

nsys-ai analyzes NVIDIA Nsight Systems profiles (.sqlite or .nsys-rep) to identify GPU bottlenecks and deliver actionable fixes, enabling faster debugging and performance improvement.

Core Features & Use Cases

  • Root-cause diagnosis: identifies bottlenecks such as NCCL contention, idle/gap issues, and MFU inefficiencies; suggests concrete fixes.
  • Diff & comparison: compares two profiles to explain regressions or improvements.
  • Guided delivery: follows universal principles to maintain evidence-based conclusions and code-change formatting in fixes.
  • Use Case: profile-driven optimization for multi-GPU workloads in DL training or GPU-accelerated workloads.

Quick Start

Provide a Nsight Systems profile (.sqlite or .nsys-rep) and run the skill to receive a root-cause and actionable fix.

Frequently Asked Questions about nsys-ai

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

FAQPage Schema
How do I identify GPU bottlenecks from an NVIDIA Nsight Systems profile?▼

To identify GPU bottlenecks from an NVIDIA Nsight Systems profile, provide the .sqlite or .nsys-rep file for analysis to receive a concrete root-cause diagnosis and actionable fix.

What is the best way to diagnose NCCL contention and idle gaps in multi-GPU workloads?▼

Diagnosing NCCL contention and idle gaps in multi-GPU workloads requires analyzing Nsight Systems profiles to pinpoint MFU inefficiencies and variance, yielding specific code-level fixes.

Can I compare two Nsight Systems profiles to explain a performance regression?▼

Yes, you can diff two Nsight Systems profiles to explain performance regressions or improvements by comparing their .sqlite or .nsys-rep data to isolate the root-cause changes.

Does the bottleneck analysis provide code examples for fixing GPU inefficiencies?▼

Yes, the bottleneck analysis provides code examples for fixing GPU inefficiencies by applying official mode references and principles to deliver evidence-based, actionable code changes.

When do I need to analyze a .nsys-rep file for deep learning training optimization?▼

You need to analyze a .nsys-rep file for deep learning training optimization when facing unresolved MFU drops or communication overhead and require profile-driven, actionable fixes to improve workload performance.