gds-test-automate

Generates unit, integration, E2E, and smoke tests for Unity, Unreal, and Godot game projects.

Updated Sep 3, 2026
One-click install
npx skills add https://github.com/watchthelight/shatterfish --skill gds-test-automate-watchthelight
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gds-test-automate
Source: https://github.com/watchthelight/shatterfish/tree/main/.claude/skills/gds-test-automate
Command: npx skills add https://github.com/watchthelight/shatterfish --skill gds-test-automate-watchthelight

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Writing automated tests for game code is time-consuming and engine-specific, requiring knowledge of NUnit, Unreal Automation Tests, or GUT patterns. This Skill analyzes a game codebase, detects the engine, and generates structured test suites with proper fixtures, cleanup, and engine conventions. ## Core Features & Use Cases - Engine Detection: Automatically identifies Unity, Unreal, or Godot projects by scanning for engine-specific files like project.godot, *.uproject, or Assets/ directories. - Multi-Level Test Generation: Produces unit tests (Arrange-Act-Assert), integration tests for scenes and levels, E2E infrastructure (fixtures, scenario builders, input simulators), and smoke tests for critical paths. - Validation & Reporting: Applies a completion checklist and writes an automation summary report listing test distribution, files created, and next steps. - Use Case: A developer with an untested Godot inventory system asks for test automation; the Skill detects Godot, loads GUT patterns, and writes parameterized unit tests plus scene integration tests under tests/. ## Quick Start Ask the assistant to automate tests for the gameplay systems in this project and generate unit, integration, and smoke tests for the detected engine.

Frequently Asked Questions about gds-test-automate

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

FAQPage Schema
How do I generate automated tests for a Unity game?

Run the test automation workflow on your Unity project; it detects the engine via Assets/ and ProjectSettings/ folders, then generates NUnit unit tests, Play Mode integration tests, and smoke tests under the tests/ directory.

How to write unit tests for Godot GDScript code?

The workflow generates GUT test files extending GutTest with before_each setup, parameterized test cases, and assert_eq assertions. Tests are written to tests/unit/ following Godot naming conventions.

Does the test generator support Unreal Engine C++ projects?

Yes, it detects Unreal projects via .uproject files and generates IMPLEMENT_SIMPLE_AUTOMATION_TEST macros and Functional Test actors with proper TestEqual assertions and engine flags.

What test types are generated for game projects?

Four types are produced: unit tests for pure logic classes, integration tests for scenes and levels, E2E infrastructure with fixtures and input simulators, and smoke tests covering launch, menus, new game, and save/load.

What are the prerequisites before running game test automation?

A test framework must already be initialized in the project, test scenarios should be defined (from a test-design workflow or ad-hoc), and the game source code must be accessible for analysis. The workflow halts if these are missing.