unity-test-runner

Unity Test Runner

Overview

This skill enables automated execution and analysis of Unity Test Framework tests directly from the command line. It handles the complete test workflow: detecting Unity Editor installations across platforms (Windows/macOS/Linux), configuring test parameters, executing tests in EditMode or PlayMode, parsing NUnit XML results, and generating detailed failure reports with actionable insights.

When to Use This Skill

Use this skill when:

• Executing Unity Test Framework tests from command line
• Running PlayMode or EditMode tests for game logic validation
• Analyzing test failures and generating failure reports
• Integrating Unity tests into CI/CD pipelines
• Debugging test failures with detailed stack traces and file locations
• Validating Unity project changes before commits

Example user requests:

• "Run all Unity tests in my project"
• "Execute PlayMode tests and show me the results"
• "Run tests in the Combat category"
• "Check if my Unity tests are passing"
• "Run EditMode tests only"

Workflow

Follow this workflow when the skill is invoked:

1. Detect Unity Editor Installation

Use the find-unity-editor.js script to automatically locate the Unity Editor:

node scripts/find-unity-editor.js --json

Script behavior:

• Scans platform-specific default installation paths
• Detects all installed Unity versions
• Returns the latest version by default
• Can target specific version with --version <version> flag

Output:

{
  "found": true,
  "editorPath": "C:\\Program Files\\Unity\\Hub\\Editor\\2021.3.15f1\\Editor\\Unity.exe",
  "version": "2021.3.15f1",
  "platform": "win32",
  "allVersions": ["2021.3.15f1", "2020.3.30f1"]
}

If multiple versions are found:

1. Present all available versions to the user
2. Ask user to confirm which version to use
3. Or use the latest version by default

If no Unity Editor is found:

• Report error with searched paths
• Ask user to provide Unity Editor path manually
• Store the path for future use