uw-unity-test-runner

Installation
SKILL.md

Unity Test Runner

Generate NUnit tests mapped from GDD Gherkin scenarios.

Before You Start

  1. Read docs/GDD.md for Gherkin scenarios (Given/When/Then) to convert into tests.
  2. Ensure a Tests.asmdef exists for the feature — create with uw-unity-feature-scaffold if needed.
  3. Read docs/CODING_STANDARDS.md for async patterns (Awaitable + CancellationToken) used in PlayMode tests.
  4. Read docs/NAMING_CONVENTIONS.md for test class and file naming.
  5. Check docs/ProjectConfig.yaml -> mcp.unity_mcp — if true, use run_tests / get_test_job to 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
Installs
3
GitHub Stars
28
First Seen
Jul 5, 2026