erhe-quest-validation

Enable Vulkan validation layers in erhe Quest builds to detect GPU hangs.

896|86|Updated May 1, 2021
One-click install
npx skills add https://github.com/tksuoran/erhe --skill erhe-quest-validation
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: erhe-quest-validation
Source: https://github.com/tksuoran/erhe/tree/main/.claude/skills/erhe-quest-validation
Command: npx skills add https://github.com/tksuoran/erhe --skill erhe-quest-validation

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill ensures that GPU hangs in erhe Quest builds are detected and reported, enhancing the debugging process.

Core Features & Use Cases

  • Vulkan Validation Layer Integration: Activates the VK_LAYER_KHRONOS_validation layer for the erhe Quest APK.
  • Runtime Configuration: Allows enabling validation layers at runtime in the erhe graphics configuration file.
  • SPIR-V Cache Management: Provides instructions to wipe the SPIR-V cache for shader recompilation with validation enabled.
  • Log Monitoring: Offers guidelines on confirming the validation layer is loaded and monitoring validation messages.
  • Disabling Validation: Instructions on how to disable validation layers for performance optimization.
  • Use Case: When encountering a Quest build that runs but renders nothing in VR, hangs at the Horizon launch panel, or misbehaves silently, this Skill can help diagnose and fix the issue.

Quick Start

Enable the validation layer in the erhe graphics configuration file and wipe the SPIR-V cache. Re-launch the erhe Quest application.

Frequently Asked Questions about erhe-quest-validation

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

FAQPage Schema
How do I enable Vulkan validation layers to debug silent GPU hangs in Quest builds?

To enable Vulkan validation layers for Quest builds, activate the VK_LAYER_KHRONOS_validation layer in the erhe graphics configuration file and wipe the SPIR-V cache to recompile shaders with validation enabled.

Why does my erhe Quest build run but render nothing in VR?

Silent rendering failures in erhe Quest builds often indicate undetected GPU hangs. Enabling Vulkan validation layers helps diagnose the issue by reporting hidden errors during the rendering pipeline.

Do I need the Vulkan SDK to use validation layers on Meta Quest?

Yes, the Vulkan SDK is required to enable validation layers in erhe Quest builds. You must modify the erhe graphics configuration file to activate the VK_LAYER_KHRONOS_validation layer at runtime.

How do I disable Vulkan validation layers for Quest performance optimization?

To disable Vulkan validation layers for performance optimization, remove or turn off the VK_LAYER_KHRONOS_validation setting in the erhe graphics configuration file before relaunching the Quest application.

How can I confirm the Vulkan validation layer is loaded in my erhe Quest application?

You can confirm the Vulkan validation layer is loaded by monitoring the application logs for validation messages after enabling it in the erhe graphics configuration and wiping the SPIR-V cache.

When should I use Vulkan validation layers for GPU debugging?

Use Vulkan validation layers for GPU debugging when a Quest build hangs at the Horizon launch panel, renders nothing in VR, or misbehaves silently, to detect and report underlying rendering failures.