shader-debug

Render GLSL fragment shaders to PNG files for visual debugging.

Updated Feb 5, 2026
One-click install
npx skills add https://github.com/pthm/soup --skill shader-debug
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: shader-debug
Source: https://github.com/pthm/soup/tree/main/.claude/skills/shader-debug
Command: npx skills add https://github.com/pthm/soup --skill shader-debug

SYSTEM DOCUMENTATION & REQUIREMENTS

## What problem does it solve? Shader-rendering issues can stall graphics development. This skill provides a fast workflow to visually validate GLSL fragment shaders by rendering them to PNG files for quick inspection.

## Core Features & Use Cases

  • Realtime shader visualization: render fragment shaders to output images to verify color and coordinate mapping.
  • Iterative debugging: isolate issues in UV handling, time uniforms, and resolution scaling by generating deterministic outputs for given inputs.
  • Lightweight setup: use the included tool with a simple go run command to generate test images from shader code.

### Quick Start To debug a shader, run: go run ./cmd/shaderdebug -shader shaders/resource.fs -out /tmp/debug.png and open the produced PNG to inspect results. Then adjust shader code and rerun as needed.

Frequently Asked Questions about shader-debug

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

FAQPage Schema
How do I debug a GLSL fragment shader visually?

Debug a GLSL fragment shader visually by rendering it to a PNG file for rapid visual inspection. Verify color and coordinate mapping by viewing the generated image output to isolate issues in your shader code.

What uniforms are available when rendering a shader for debugging?

When rendering a shader for debugging, the tool automatically provides time and resolution uniforms. These inputs help isolate issues with time-based animations and resolution scaling in your fragment shaders.

How can I test GLSL shaders at different resolutions?

You can test GLSL shaders at different resolutions by specifying optional width and height parameters during rendering. This generates deterministic outputs for given inputs to validate resolution scaling across various dimensions.

Can I use this tool to create regression tests for shader rendering?

Yes, you can use this tool to create regression tests for shader rendering by generating deterministic PNG outputs for given inputs. This allows you to compare rendered images across different shader versions and resolutions.

Do I need a GPU to render GLSL shaders to PNG files?

The metadata does not specify GPU requirements for rendering GLSL shaders to PNG files. The tooling operates via a simple command line execution to generate test images from your shader code.