scene-open

Opens Unity scene assets in single or additive load modes via unity-mcp-cli.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires unity-mcp-cli.

What problem does it solve? Opening Unity scenes programmatically requires editor access and manual navigation; this Skill lets an AI agent open any scene asset in a Unity project directly through the unity-mcp-cli tool with a single command. ## Core Features & Use Cases - Scene Loading by Reference: Open a scene using its asset path, GUID, or instance ID via the sceneRef parameter. - Flexible Load Modes: Choose Single mode to replace current scenes, or Additive/AdditiveWithoutLoading to stack scenes on top of the current one. - Structured Output: Returns scene metadata including load state, dirty flag, root count, build index, and project path. - Use Case: While building a multi-scene Unity game, ask the agent to open 'Assets/Scenes/Level2.unity' additively so you can inspect lighting alongside the main scene without closing your work. ## Quick Start Use the assets-find tool to locate the scene asset, then ask the agent to open that scene in Single mode with the scene-open tool.

Frequently Asked Questions about scene-open

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

FAQPage Schema
How do I open a Unity scene from the command line?

Run unity-mcp-cli run-tool scene-open with a JSON input containing a sceneRef pointing to the scene asset. The sceneRef can use an assetPath starting with 'Assets/', an assetGuid, or an instanceID.

What is the difference between Single and Additive scene load modes in Unity?

Single mode closes all currently open scenes before opening the new one. Additive keeps the current scenes open and loads the new scene alongside them, while AdditiveWithoutLoading adds it without activating its content.

How do I find the scene asset reference before opening it?

Use the assets-find tool to search the project's Assets and Packages folders for the scene file. It returns the asset path, GUID, and instanceID needed to construct the sceneRef input.

Why is unity-mcp-cli not found when running the command?

The CLI is not installed or not on your PATH. Install it globally with npm install -g unity-mcp-cli, or prefix commands with npx unity-mcp-cli, and check the unity-initial-setup skill for full setup instructions.

Can I open multiple Unity scenes at the same time?

Yes, use the Additive loadSceneMode to keep existing scenes open while loading an additional one. The output returns an array of scene data showing the load state of each open scene.