tests-run

Execute Unity tests and return detailed results with filtering options.

1|Updated Apr 1, 2026
One-click install
npx skills add https://github.com/Fermisloth/Project-Aegis-Adaptive-Outbreak-Containment --skill tests-run-fermisloth
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tests-run
Source: https://github.com/Fermisloth/Project-Aegis-Adaptive-Outbreak-Containment/tree/main/.agent/skills/tests-run
Command: npx skills add https://github.com/Fermisloth/Project-Aegis-Adaptive-Outbreak-Containment --skill tests-run-fermisloth

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires unity-mcp-cli.

What problem does it solve? Running Unity tests manually through the editor is slow and disrupts development flow, especially when you only need to verify a specific class or method. This Skill executes Unity tests directly via the unity-mcp-cli and returns structured results including pass/fail status, messages, stack traces, and console logs. ## Core Features & Use Cases - Flexible Test Filtering: Run tests by mode (EditMode or PlayMode), assembly, namespace, class, or a fully qualified method name. - Detailed Result Reporting: Retrieve per-test status, duration, failure messages, stack traces, and filtered console logs. - Fast Iteration: Default EditMode execution enables quick feedback loops during development without entering Play Mode. - Use Case: After modifying a gameplay script, run only the affected test class to confirm nothing broke, then inspect failure stack traces and error logs without opening the Unity Test Runner window. ## Quick Start Run all EditMode tests in the project and show me any failures with their stack traces.

Frequently Asked Questions about tests-run

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

FAQPage Schema
How do I run Unity tests from the command line?

Use the unity-mcp-cli run-tool tests-run command with a JSON input specifying testMode and optional filters. EditMode is the default and fastest option for iteration, while PlayMode runs tests in a runtime scene context.

How to run a single Unity test method instead of the full suite?

Pass the testMethod parameter with the fully qualified name, such as MyTestNamespace.FixtureName.TestName. You can also narrow scope using testAssembly, testNamespace, or testClass filters.

What is the difference between EditMode and PlayMode tests in Unity?

EditMode tests run in the editor without entering Play Mode, making them faster for development iteration. PlayMode tests execute in a running scene and are suited for testing runtime behavior and scene interactions.

Why is unity-mcp-cli not found when running tests?

The CLI is not installed or not on your PATH. Install it globally with npm install -g unity-mcp-cli, or invoke it via npx unity-mcp-cli, then retry the test run command.

How do I see console logs and stack traces from failed Unity tests?

Set includeStacktrace and includeLogs to true in the input JSON, and choose a logType filter such as Error or Warning. Avoid includeLogsStacktrace unless necessary since it produces very large output.