uw-unity-test-runner
Installation
SKILL.md
Unity Test Runner
Generate NUnit tests mapped from GDD Gherkin scenarios.
Before You Start
- Read
docs/GDD.mdfor Gherkin scenarios (Given/When/Then) to convert into tests. - Ensure a
Tests.asmdefexists for the feature — create withuw-unity-feature-scaffoldif needed. - Read
docs/CODING_STANDARDS.mdfor async patterns (Awaitable+CancellationToken) used in PlayMode tests. - Read
docs/NAMING_CONVENTIONS.mdfor test class and file naming. - Check
docs/ProjectConfig.yaml -> mcp.unity_mcp— iftrue, userun_tests/get_test_jobto execute tests. Otherwise, instruct the user to run via Unity Editor (Window -> General -> Test Runner).
Test Types
| Type | Location | When to Use | Runner |
|---|---|---|---|
| EditMode | Tests/EditMode/ |
Pure logic — no MonoBehaviour lifecycle, no scene required | [Test] with NUnit |
| PlayMode | Tests/PlayMode/ |
Needs Awake/Start/Update, scene loading, physics, or coroutines |
[UnityTest] + IEnumerator |