SC

scene-unload

Unloads scenes from the Unity Editor using a standardized command line tool.

Install

mkdir -p .claude/skills/scene-unload && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/17784" && unzip -o skill.zip -d .claude/skills/scene-unload && rm skill.zip

Installs to .claude/skills/scene-unload

Activation

This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.

Unload scene from the Opened scenes in Unity Editor. Use 'scene-list-opened' tool to get the list of all opened scenes.
119 charsno explicit “when” trigger
Beginner

Key capabilities

  • Unload a specified scene from Unity Editor
  • Identify the name of the scene to unload
  • Execute the `unity-mcp-cli run-tool scene-unload` command
  • Provide JSON schema for input parameters
  • Provide JSON schema for output results

How it works

The skill executes a command-line tool, `unity-mcp-cli run-tool scene-unload`, with the provided scene name as input. This action removes the specified scene from the Unity Editor's opened scenes.

Inputs & outputs

You give it
The name of the scene to unload
You get back
A JSON object confirming the name of the unloaded scene and its asset reference

When to use scene-unload

  • Managing open scenes
  • Cleaning up unity workspace

About this skill

Scene / Unload

How to Call

unity-mcp-cli run-tool scene-unload --input '{
  "name": "string_value"
}'

For complex input (multi-line strings, code), save the JSON to a file and use:

unity-mcp-cli run-tool scene-unload --input-file args.json

Or pipe via stdin (recommended):

unity-mcp-cli run-tool scene-unload --input-file - <<'EOF'
{"param": "value"}
EOF

Troubleshooting

If unity-mcp-cli is not found, either install it globally (npm install -g unity-mcp-cli) or use npx unity-mcp-cli instead. Read the /unity-initial-setup skill for detailed installation instructions.

Input

NameTypeRequiredDescription
namestringYesName of the loaded scene.

Input JSON Schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string"
    }
  },
  "required": [
    "name"
  ]
}

Output

Output JSON Schema

{
  "type": "object",
  "properties": {
    "result": {
      "$ref": "#/$defs/AIGD.UnloadSceneResult"
    }
  },
  "$defs": {
    "AIGD.AssetObjectRef": {
      "type": "object",
      "properties": {
        "instanceID": {
          "type": "integer",
          "description": "instanceID of the UnityEngine.Object. If this is '0' and 'assetPath' and 'assetGuid' is not provided, empty or null, then it will be used as 'null'."
        },
        "assetType": {
          "$ref": "#/$defs/System.Type",
          "description": "Type of the asset."
        },
        "assetPath": {
          "type": "string",
          "description": "Path to the asset within the project. Starts with 'Assets/'"
        },
        "assetGuid": {
          "type": "string",
          "description": "Unique identifier for the asset."
        }
      },
      "required": [
        "instanceID"
      ],
      "description": "Reference to UnityEngine.Object asset instance. It could be Material, ScriptableObject, Prefab, and any other Asset. Anything located in the Assets and Packages folders."
    },
    "System.Type": {
      "type": "string"
    },
    "AIGD.UnloadSceneResult": {
      "type": "object",
      "properties": {
        "Name": {
          "type": "string",
          "description": "Name of the unloaded scene."
        },
        "AssetObjectRef": {
          "$ref": "#/$defs/AIGD.AssetObjectRef",
          "description": "Reference to the unloaded scene asset."
        }
      }
    }
  },
  "required": [
    "result"
  ]
}

When not to use it

  • When the task is not related to unloading scenes in Unity Editor
  • When the scene name is unknown or not provided
  • When the `unity-mcp-cli` tool is not installed or accessible

Limitations

  • Requires the `unity-mcp-cli` tool to be installed
  • Requires the exact name of the loaded scene
  • The skill only unloads scenes, it does not load or list them

How it compares

This skill provides a direct command-line interface to unload Unity scenes, offering a programmatic way to manage open scenes rather than manual interaction within the Unity Editor.

Compared to similar skills

scene-unload side by side with the closest alternatives in the catalog.

SkillInstallsUpdatedSafetyDifficulty
scene-unload (this skill)02moReviewBeginner
applescript288moReviewAdvanced
bazel-build-optimization142moNo flagsAdvanced
home-assistant-manager98moReviewAdvanced

Try saying

Example prompts that trigger this skill in your AI assistant.

Search skills

Search the agent skills registry