gds-test-framework

Scaffolds test framework infrastructure for Unity, Unreal, or Godot game projects.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up a game testing framework from scratch requires engine-specific knowledge of directory structures, assembly definitions, build modules, and configuration files, which slows teams down before they write a single test. ## Core Features & Use Cases - Engine Detection: Automatically identifies Unity, Unreal, or Godot projects by inspecting project files such as ProjectSettings.asset, .uproject files, or project.godot. - Framework Scaffolding: Creates the correct directory structure, configuration files (asmdef, Build.cs, gut_config.json), and working sample tests for the detected engine. - Documentation Generation: Produces a tests/README.md with run instructions, CI integration commands, and best practices. - Use Case: A team starting a new Godot project can run this workflow to get a GUT-based test setup with sample unit and integration tests, ready to extend with real game tests. ## Quick Start Set up a test framework for my game project by detecting the engine and scaffolding the appropriate testing infrastructure.

Frequently Asked Questions about gds-test-framework

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

FAQPage Schema
How do I set up a test framework for a Unity game project?

The workflow creates Assets/Tests with EditMode and PlayMode subdirectories, generates the required .asmdef assembly definitions with UNITY_INCLUDE_TESTS constraints, and adds sample NUnit tests. It also produces a tests README with run and CI instructions.

How to add automated tests to an Unreal Engine project?

The workflow creates a Source/<ProjectName>Tests module with a Build.cs file referencing the game module and AutomationController, plus sample automation tests using IMPLEMENT_SIMPLE_AUTOMATION_TEST with ProductFilter flags.

What test framework does Godot use for unit testing?

This workflow uses GUT (Godot Unit Test), installed under addons/gut/, with a gut_config.json pointing at tests/unit and tests/integration directories. Sample tests extend GutTest and use before_each/after_each lifecycle hooks.

Can I run this setup if a test framework already exists?

No. The preflight check halts if an existing test framework is detected, such as a Tests folder, Tests.asmdef, or GUT plugin. It offers an upgrade path or stops to avoid overwriting your current configuration.

Does the workflow support engines other than Unity, Unreal, and Godot?

No. Engine detection only covers Unity, Unreal, and Godot, identified via files like ProjectSettings.asset, .uproject, or project.godot. Projects using other engines are not supported by this workflow.