scene-open

Opens Unity scenes from project asset files via the unity-mcp-cli tool.

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

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 you open any scene asset in a Unity project directly through a CLI command, with control over single or additive load modes. ## Core Features & Use Cases - Scene Loading by Reference: Open a scene using an asset path, GUID, or instance ID reference to any asset in the Assets or Packages folders. - Flexible Load Modes: Choose Single mode to replace current scenes, or Additive/AdditiveWithoutLoading to stack scenes on top of the current one. - Structured Scene Output: Returns scene metadata including load state, dirty flag, root count, build index, and path. - Use Case: While building a level, ask the AI to open 'Assets/Scenes/Level2.unity' in additive mode to inspect it alongside your current working scene without losing context. ## Quick Start Use the scene-open skill to open the scene asset at Assets/Scenes/Main.unity in Single mode, finding it first with the assets-find tool if needed.

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 by path, GUID, or instance ID. The scene opens in the connected Unity Editor and returns its load state and metadata.

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

Use the assets-find tool to locate the scene asset in your project first, then pass its path, GUID, or instance ID as the sceneRef. The reference works for any asset located in the Assets or Packages folders.

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

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

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

Can I open multiple Unity scenes at once with this tool?▼

Yes, by using the Additive loadSceneMode you can open additional scenes while keeping current ones loaded. Repeat the command for each scene you want to stack.