scene-set-active

Sets an opened Unity scene as the Editor's active scene via EditorSceneManager.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires unity-mcp-cli.

What problem does it solve? When multiple scenes are open in the Unity Editor, new GameObjects are added to the active scene by default, so automating scene operations requires explicitly controlling which scene is active. This Skill marks a specified opened scene as active without manual Editor interaction. ## Core Features & Use Cases - Active Scene Control: Resolves a SceneAsset reference and calls EditorSceneManager.SetActiveScene to make it the active scene. - Idempotent Behavior: Performs a no-op if the target scene is already active, and returns a post-call snapshot of all opened scenes. - Use Case: While building a multi-scene level through an AI agent, list opened scenes with scene-list-opened, then set the gameplay scene active so subsequently created GameObjects land in the correct scene. ## Quick Start Ask the agent to set the scene at Assets/Scenes/Gameplay.unity as the active scene using the scene-set-active tool.

Frequently Asked Questions about scene-set-active

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

FAQPage Schema
How do I set the active scene in the Unity Editor from a script?▼

Call EditorSceneManager.SetActiveScene with the target Scene struct. This Skill wraps that call: provide a sceneRef pointing at a SceneAsset, and it resolves the matching opened scene by name then path before setting it active.

How do I find which scenes are currently open in Unity?▼

Use the scene-list-opened tool to enumerate all opened scenes before calling scene-set-active. The target scene must already be opened; otherwise the reference cannot be resolved to an active scene candidate.

Can I set a scene active that is not currently opened in Unity?▼

No. The scene must already be opened in the Editor. The tool resolves the SceneAsset against opened scenes by name and path, so open the scene first with a scene-open tool before marking it active.

What happens if the scene is already the active scene?▼

The operation is a no-op when the target scene is already active. The tool still returns a post-call snapshot of all opened scenes, including their loaded, dirty, and build index states.

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

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, then retry the run-tool command.