scene-unload

Unload an opened scene from the Unity Editor asynchronously via SceneManager.UnloadSceneAsync.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires unity-mcp-cli.

What problem does it solve? Managing multiple open scenes in the Unity Editor often requires manual cleanup, and unloading the wrong scene or forgetting which scenes are open can break a level-building workflow. This Skill unloads a specific opened scene by name through the unity-mcp-cli, returning a structured result with a reference to the scene asset. ## Core Features & Use Cases - Asynchronous Scene Unloading: Runs SceneManager.UnloadSceneAsync on the main thread and awaits completion. - Structured Result: Returns an UnloadSceneResult containing the scene name and an AssetObjectRef to its asset, or null if the scene was not backed by an asset on disk. - Use Case: While assembling a multi-scene level, you finish editing the lighting scene and ask the AI to unload it by name, keeping only the active gameplay scenes open. ## Quick Start Ask the AI to unload the opened Unity scene named 'Lighting' using the scene-unload tool, after listing opened scenes with scene-list-opened to confirm the exact name.

Frequently Asked Questions about scene-unload

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

FAQPage Schema
How do I unload a scene in the Unity Editor from the command line?▼

Run unity-mcp-cli run-tool scene-unload with a JSON input containing the scene name, for example {"name": "Lighting"}. The tool calls SceneManager.UnloadSceneAsync on the main thread and awaits completion.

How do I find the name of an opened Unity scene before unloading it?▼

Use the scene-list-opened tool to get the list of all currently opened scenes in the Unity Editor. The name passed to scene-unload must exactly match one of those opened scenes, otherwise the call throws an error.

What happens if the scene name does not match an opened scene?▼

The tool throws an error because the name parameter must match a currently opened scene. Always verify the exact scene name with scene-list-opened before calling scene-unload.

What does the scene-unload tool return after unloading?▼

It returns an UnloadSceneResult containing the unloaded scene's name and an AssetObjectRef pointing to the scene asset. The AssetObjectRef is null if the scene was not backed by an asset on disk.

Why is unity-mcp-cli not found when running scene-unload?▼

The CLI is either 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, and check the unity-initial-setup skill for detailed installation steps.