scene-open

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

Updated May 27, 2026
One-click install
npx skills add https://github.com/AdielMag/ClashUp --skill scene-open-adielmag
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: scene-open
Source: https://github.com/AdielMag/ClashUp/tree/main/client/ClashUp.Unity/.claude/skills/scene-open
Command: npx skills add https://github.com/AdielMag/ClashUp --skill scene-open-adielmag

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires unity-mcp-cli.

What problem does it solve? Opening Unity scenes programmatically requires editor scripting knowledge and manual scene management. This Skill lets you open any scene asset in the Unity Editor through a single CLI command, choosing whether to replace the current scenes or load additively, and immediately returns the state of all opened scenes. ## Core Features & Use Cases - Single Mode Opening: Closes all currently opened scenes and opens the target scene, ideal for switching between levels during development. - Additive Mode Opening: Keeps existing scenes open and loads the new scene alongside them, supporting multi-scene workflows like lighting or UI overlays. - Post-Open Scene Report: Returns a list of all opened scenes with metadata such as load state, dirty flag, root count, path, and build index. - Use Case: While iterating on a multiplayer arena map, ask the AI to open the main arena scene additively on top of your shared environment scene, then verify both scenes loaded correctly from the returned scene list. ## Quick Start Ask the AI to open the scene asset at Assets/Scenes/Arena.unity in Single mode using the scene-open tool and confirm the opened scenes list.

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. The sceneRef can use an instanceID, asset path starting with Assets/, or asset GUID to resolve the scene.

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

Single mode closes all currently opened scenes before opening the target scene. Additive mode keeps the current scenes open and loads the new scene alongside them, which is useful for multi-scene setups like shared lighting or UI layers.

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

Use the assets-find tool to locate the scene asset in the project first. It returns the AssetObjectRef containing the instanceID, path, or GUID that scene-open requires as its sceneRef input.

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

The tool throws an error if the sceneRef cannot be resolved or does not point to a SceneAsset. Verify the asset path starts with Assets/, the GUID is correct, or the instanceID is valid, and confirm the asset is actually a scene file.

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

Install it globally with npm install -g unity-mcp-cli, or prefix commands with npx unity-mcp-cli. The unity-initial-setup skill provides detailed installation instructions for the CLI.