gds-test-framework

Scaffolds test frameworks with sample tests and documentation for Unity, Unreal, and Godot projects.

1|Updated Sep 18, 2026
One-click install
npx skills add https://github.com/PastaSus/egg-defender --skill gds-test-framework-pastasus
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gds-test-framework
Source: https://github.com/PastaSus/egg-defender/tree/main/.agents/skills/gds-test-framework
Command: npx skills add https://github.com/PastaSus/egg-defender --skill gds-test-framework-pastasus

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up a testing infrastructure for a game project requires engine-specific knowledge of directory structures, assembly definitions, build modules, and framework configuration, which is time-consuming and error-prone when done manually. ## Core Features & Use Cases - Automatic Engine Detection: Identifies Unity, Unreal Engine, or Godot projects by scanning for engine-specific files like ProjectSettings.asset, .uproject, or project.godot. - Framework Scaffolding: Creates the complete test 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 setup instructions, CI integration commands, and testing best practices. - Use Case: A developer starting a new Godot project runs this workflow to instantly get a GUT-based test setup with unit and integration test examples, ready to extend with real game tests. ## Quick Start Ask the assistant to set up a test framework for your game project and it will detect your engine and scaffold everything needed.

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?

This 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 README explaining how to run tests locally and in CI.

How do I 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 testing framework does Godot use for unit tests?

This workflow uses GUT (Godot Unit Test), installing the plugin under addons/gut/ and creating tests/unit and tests/integration directories with a gut_config.json. Sample tests extend GutTest and use before_each/after_each lifecycle methods.

Can I run this setup if my project already has tests configured?

The workflow checks for existing test frameworks first, such as Tests folders, .Tests.asmdef files, or the GUT plugin. If one is detected, it halts and offers an upgrade path instead of overwriting your existing setup.

How does the workflow know which game engine my project uses?

It scans for engine-specific files: ProjectSettings.asset and .unity scenes for Unity, .uproject and DefaultEngine.ini for Unreal, and project.godot with .gd files for Godot. It also detects the engine version from ProjectVersion.txt, EngineAssociation, or config_version.