gds-test-framework

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

6|Updated Aug 29, 2026
One-click install
npx skills add https://github.com/HordRicJr/Akomagni --skill gds-test-framework-hordricjr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gds-test-framework
Source: https://github.com/HordRicJr/Akomagni/tree/main/bmad-core/.agents/skills/gds-test-framework
Command: npx skills add https://github.com/HordRicJr/Akomagni --skill gds-test-framework-hordricjr

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 test framework configuration, which is time-consuming to assemble from scratch. ## Core Features & Use Cases - Engine Detection: Automatically identifies Unity, Unreal Engine, 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 setup instructions, CI integration commands, and testing best practices. - Use Case: A developer starting a Godot project asks to set up testing, and the workflow installs the GUT structure, generates unit and integration test examples, and documents how to run them. ## Quick Start Set up a test framework for my game project and generate sample tests for the detected engine.

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 .asmdef assembly definitions with UNITY_INCLUDE_TESTS constraints, and adds sample NUnit tests. It also produces a tests/README.md explaining how to run them.

How to write unit tests for a Godot game with GUT?

The workflow scaffolds a tests/ directory with unit and integration subfolders, creates a gut_config.json pointing at res://tests/, and generates sample tests extending GutTest with before_each and after_each lifecycle methods.

Does this support Unreal Engine automation testing?

Yes, it 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 happens if a test framework already exists in my project?

The workflow checks for existing test directories, asmdef files, Build.cs test modules, or the GUT plugin during preflight. If an existing framework is detected, it halts and offers an upgrade path instead of overwriting.

How does the workflow detect which game engine I am using?

It inspects 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 reads engine version information from these files.