tests-run

Execute Unity EditMode and PlayMode tests and return structured results.

Updated May 28, 2026
One-click install
npx skills add https://github.com/ishaansingh-ai/Mechanical-2D --skill tests-run-ishaansingh-ai
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: tests-run
Source: https://github.com/ishaansingh-ai/Mechanical-2D/tree/main/.claude/skills/tests-run
Command: npx skills add https://github.com/ishaansingh-ai/Mechanical-2D --skill tests-run-ishaansingh-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires unity-mcp-cli.

What problem does it solve? Running Unity tests manually through the editor UI is slow and hard to automate, especially when you need filtered results, failure details, or console logs for debugging. ## Core Features & Use Cases - Filtered Test Execution: Run tests by mode (EditMode or PlayMode), assembly, namespace, class, or a single fully qualified method. - Detailed Result Reporting: Retrieve pass/fail summaries, per-test messages, stack traces, and captured console logs with log-type filtering. - Use Case: After refactoring a gameplay system, run only the affected test class in EditMode to quickly verify nothing broke, then inspect failure messages and stack traces without opening the Unity Test Runner window. ## Quick Start Run all EditMode tests in the Unity project and show me any failures with their messages and 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 the test mode and optional filters. It executes tests inside the connected Unity Editor and returns structured results including pass/fail status and messages.

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

Pass the testMethod parameter with the fully qualified method 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 iteration. PlayMode tests run in a runtime scene context and suit gameplay or integration scenarios. EditMode is the default and recommended for faster development loops.

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. Refer to the unity-initial-setup skill for full installation instructions.

Can I capture Unity console logs during a test run?▼

Yes, set includeLogs to true and optionally filter by logType such as Error, Warning, or Exception. Avoid includeLogsStacktrace unless necessary, since it produces a very large amount of output data.