debug-cuda-crash

Record CUDA kernel calls and tensor states to diagnose GPU errors.

12|2|Updated Mar 22, 2026
One-click install
npx skills add https://github.com/scottgl9/sglang-spark-gb10-optimizations --skill debug-cuda-crash-scottgl9
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug-cuda-crash
Source: https://github.com/scottgl9/sglang-spark-gb10-optimizations/tree/main/.claude/skills/debug-cuda-crash
Command: npx skills add https://github.com/scottgl9/sglang-spark-gb10-optimizations --skill debug-cuda-crash-scottgl9

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps developers debug CUDA crashes by providing detailed kernel API logs and tensor data snapshots, reducing the time spent on diagnosing GPU errors.

Core Features & Use Cases

  • Kernel API Logging: Records detailed function calls, inputs, and outputs to track down the source of CUDA errors.
  • Tensor Inspection: Captures tensor shapes, dtypes, and values before crashes occur, aiding in identifying erroneous data.
  • Use Case: When encountering mysterious CUDA illegal memory accesses, use this Skill to log kernel calls and tensor states to pinpoint shape mismatches or NaNs.

Quick Start

Call this Skill before running your CUDA code to enable kernel API logging and tensor dumps for easier debugging.

Frequently Asked Questions about debug-cuda-crash

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

FAQPage Schema
How do I debug a CUDA illegal memory access crash?

Debugging a CUDA illegal memory access crash requires logging detailed kernel API calls and capturing tensor states before the failure. This Skill records function inputs and outputs to help pinpoint shape mismatches, NaNs, or illegal memory accesses during GPU computation.

What is the best way to find shape mismatches causing GPU errors?

Finding shape mismatches causing GPU errors involves inspecting tensor shapes and dtypes right before crashes occur. This Skill captures tensor data snapshots and logs kernel calls to aid in identifying erroneous data inputs during computation tasks.

How does kernel API logging help diagnose CUDA crashes?

Kernel API logging helps diagnose CUDA crashes by recording detailed function calls, inputs, and outputs during execution. This tracking mechanism reveals the exact sequence of GPU operations leading up to tensor state errors or illegal memory accesses.

Can I inspect tensor values and dtypes before a CUDA crash happens?

Yes, you can inspect tensor values and dtypes before a CUDA crash happens by enabling tensor data snapshots. This Skill captures tensor shapes and values during GPU computation to help identify NaNs or erroneous data causing the crash.

When do I need to enable kernel API logging for GPU computation tasks?

You need to enable kernel API logging for GPU computation tasks when encountering mysterious CUDA errors like illegal memory accesses. Activating this logging before running your code captures the detailed function calls needed to diagnose shape mismatches or NaNs.