probes-and-shots

Automate headless verification of Godot 4.6 game scenes with GDScript probes and screenshots.

Updated Jun 15, 2026
One-click install
npx skills add https://github.com/tcober/ProfessorPoopyPawsGodot --skill probes-and-shots
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: probes-and-shots
Source: https://github.com/tcober/ProfessorPoopyPawsGodot/tree/main/.claude/skills/probes-and-shots
Command: npx skills add https://github.com/tcober/ProfessorPoopyPawsGodot --skill probes-and-shots

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This skill addresses the high cost of manual game testing by providing a suite of headless probes and screenshot tools to verify scene integrity, movement logic, and state transitions in Godot 4.6 without launching the full game.

Core Features & Use Cases

  • Automated Scene Probing: Run headless tests for specific game chapters, combat systems, and movement logic to catch regressions early.
  • Visual Regression Testing: Generate contact sheets and screenshots of scenes to visually verify Z-ordering, prop placement, and character poses.
  • Use Case: After modifying a map's geometry or NPC placement, run the zwalk probe to automatically detect layering errors or collision issues across all scene strata.

Quick Start

Run the probes-and-shots skill to execute the library_probe and verify the current state of the library scene.

Frequently Asked Questions about probes-and-shots

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

FAQPage Schema
How do I run headless regression tests for Godot scenes?

Run headless regression tests for Godot scenes by executing GDScript probes that verify scene integrity, movement logic, and state transitions without launching the full game. This suite automates verification for character movement, combat systems, and scene geometry across story chapters.

Can I generate automated screenshots of Godot scenes for visual regression testing?

Yes, you can generate automated screenshots and contact sheets of Godot scenes for visual regression testing. This allows you to visually verify Z-ordering, prop placement, and character poses to detect layering errors or collision issues across scene strata.

Does Godot headless testing require special input simulation and frame capping?

Godot headless testing requires strict adherence to headless environment constraints including frame capping, polled input simulation, and proper scene lifecycle management. These constraints ensure automated probes execute reliably without a graphical interface.

What is the best way to automate collision and layering error detection in Godot?

The best way to automate collision and layering error detection in Godot is using specialized scene probes like the zwalk probe. It automatically detects layering errors or collision issues across all scene strata after modifying map geometry or NPC placement.

How do automated GDScript probes verify character movement and combat systems?

Automated GDScript probes verify character movement and combat systems by running headless tests that check specific game chapters and state transitions. This catches regressions early by validating movement logic and combat interactions without manual gameplay.