graphics-debug

Debug Unreal Engine rendering crashes with GPU hang and RHI thread diagnostics.

1|1|Updated Dec 1, 2025
One-click install
npx skills add https://github.com/sipherxyz/universal-ue-skills --skill graphics-debug-sipherxyz
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: graphics-debug
Source: https://github.com/sipherxyz/universal-ue-skills/tree/main/skills/graphics-debug
Command: npx skills add https://github.com/sipherxyz/universal-ue-skills --skill graphics-debug-sipherxyz

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps developers diagnose and fix complex rendering crashes in Unreal Engine, specifically those related to GPU hangs, RHI thread issues, and shader errors.

Core Features & Use Cases

  • RHI Thread Serialization: Moves rendering commands to a stable thread for readable callstacks.
  • GPU Crash Dump Analysis: Enables Nvidia Nsight shader symbols and GPU crash dumps for deep GPU debugging.
  • Nanite Bisection: Helps isolate crashes within Nanite rendering features.
  • Use Case: When your Unreal Engine game crashes with a cryptic GPU error or a noisy callstack, this Skill provides a systematic approach to enable the necessary debugging tools and interpret the results to pinpoint the root cause.

Quick Start

Run /system-architect:graphics-debug shader gpu-crash+dred to enable full GPU debugging with DRED and Nsight symbols.

Frequently Asked Questions about graphics-debug

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

FAQPage Schema
How do I debug a GPU hang in Unreal Engine?

To debug an Unreal Engine GPU hang, enable GPU crash dumps alongside Nvidia Nsight shader symbols to capture deep diagnostic data for GPU-side faults. This Skill provides the necessary console variables and command-line arguments to generate detailed diagnostic reports.

What is RHI thread serialization for rendering crashes?

RHI thread serialization moves rendering commands to a stable thread to produce readable callstacks during a crash. It helps diagnose CPU-side RHI issues by preventing noisy, multi-threaded callstacks from obscuring the root cause of the rendering failure.

How do I enable D3D12 DRED for Unreal Engine GPU crashes?

You can enable D3D12 DRED for Unreal Engine GPU crashes by running the command to activate full GPU debugging with DRED and Nsight symbols. This provides a systematic approach to capture detailed diagnostic information for GPU-side faults.

How do I isolate a Nanite rendering crash in Unreal Engine?

To isolate a Nanite rendering crash in Unreal Engine, this Skill provides a bisection methodology to narrow down the specific Nanite feature causing the fault. It guides you through enabling targeted console variables to systematically test and identify the problematic rendering component.

Why does my Unreal Engine game crash with a noisy callstack during rendering?

An Unreal Engine rendering crash often produces a noisy callstack because commands execute asynchronously across multiple threads. Enabling RHI thread serialization moves commands to a stable thread, delivering readable callstacks to pinpoint the CPU-side root cause.