test-helpers

Generate engine-specific test helper libraries with assertions, factories, and mocks for game projects.

Updated Aug 2, 2026
One-click install
npx skills add https://github.com/claretagrapelike32/codex-ai-game-studio --skill test-helpers-claretagrapelike32
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: test-helpers
Source: https://github.com/claretagrapelike32/codex-ai-game-studio/tree/main/plugins/ai-game-studio/skills/test-helpers
Command: npx skills add https://github.com/claretagrapelike32/codex-ai-game-studio --skill test-helpers-claretagrapelike32

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Writing game tests involves repeating the same setup, teardown, and assertion boilerplate across every test file. This Skill reads your existing test patterns and generates a tailored tests/helpers/ library so developers write more assertions and less boilerplate. ## Core Features & Use Cases - Engine-Specific Generation: Produces helper code for Godot 4 (GDUnit4/GDScript), Unity (NUnit/C#), and Unreal Engine (C++ automation tests) based on your project configuration. - Pattern Matching: Scans existing test files to extract setup, assertion, and mocking patterns so generated helpers match your project's style rather than a generic template. - GDD-Traced Constants: Derives bounds and constants in generated helpers from GDD Formulas sections, keeping test expectations traceable to design documents. - Use Case: After scaffolding a test framework for a Godot project, run the skill in scaffold mode to create game_assertions.gd and game_factory.gd, then generate a combat-specific factory whose damage bounds come directly from the combat GDD. ## Quick Start Ask the AI to run $ai-game-studio:test-helpers scaffold to generate the base test helper library for your configured engine.

Frequently Asked Questions about test-helpers

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

FAQPage Schema
How do I generate test helper libraries for a Godot game project?

Run the skill in scaffold mode after your test framework is set up. It detects Godot 4 and GDUnit4 from your project configuration and generates game_assertions.gd, game_factory.gd, and scene_runner_helper.gd in tests/helpers/.

How to reduce boilerplate in Unity NUnit test files?

Generate a GameAssertions static class with helpers like AssertInRange and AssertHasComponent, plus a GameFactory for creating minimal GameObjects and ScriptableObjects. The skill produces these C# files tailored to your existing test patterns.

Does the test helper generator support Unreal Engine C++ tests?

Yes, it generates a GameTestHelpers.h header with assertion macros like GAME_TEST_ASSERT_IN_RANGE and a CreateTestWorld utility for Unreal automation tests. Include the header in any test file needing domain-specific assertions.

Will generating test helpers overwrite my existing helper files?

No, the skill never overwrites existing files. If a helper file already exists, it skips that file and reports it, since existing helpers may contain hand-written customizations.

What happens if my game engine is not configured before generating helpers?

The skill reads the engine, language, and test framework from .ai-game-studio/project.json. If the engine is not configured, it stops and instructs you to run the setup-engine step first.