scene-open

Opens a Unity scene asset in Single or Additive mode and returns all opened scenes.

Updated Jul 20, 2026
One-click install
npx skills add https://github.com/PMK95/GridSquad --skill scene-open-pmk95
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: scene-open
Source: https://github.com/PMK95/GridSquad/tree/main/GridSquadUnity/.agents/skills/scene-open
Command: npx skills add https://github.com/PMK95/GridSquad --skill scene-open-pmk95

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires unity-mcp-cli.

What problem does it solve? Opening Unity scenes programmatically requires resolving asset references and managing load modes correctly. This Skill opens a scene asset through the unity-mcp-cli tool and returns the full list of currently opened scenes, removing manual Editor interaction from automated workflows. ## Core Features & Use Cases - Scene Opening by Asset Reference: Opens any SceneAsset resolved via an AssetObjectRef (instanceID, asset path, or GUID). - Load Mode Control: Supports Single mode to replace current scenes or Additive mode to open scenes alongside existing ones. - Post-Open Scene State: Returns the complete list of opened scenes with metadata such as path, build index, dirty state, and root count. - Use Case: While building a level, use the assets-find tool to locate 'Assets/Scenes/Level2.unity', then open it in Additive mode to inspect it alongside the main scene without losing your current work. ## Quick Start Ask the AI to find the scene asset with assets-find and then open it using scene-open with the desired loadSceneMode.

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 SceneAsset. Use the assets-find tool first to locate the scene asset and obtain its reference.

What is the difference between Single and Additive scene loading in Unity?▼

Single mode closes all currently opened scenes and opens only the target scene. Additive mode keeps the current scenes open and loads the new scene alongside them, which is useful for multi-scene editing workflows.

How do I reference a Unity scene asset for scene-open?▼

Provide an AssetObjectRef with the asset's instanceID, assetPath starting with 'Assets/', or assetGuid. The reference must resolve to a SceneAsset or the call throws an error.

Why does scene-open fail to resolve my scene asset?▼

Resolution fails when the sceneRef does not point to a valid SceneAsset or the asset cannot be found in the project. Verify the asset path or GUID using the assets-find tool before calling scene-open.

What should I do if unity-mcp-cli is not found?▼

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 detailed installation instructions.