unity-scene

Create, load, save, and inspect Unity scenes and their GameObject hierarchies.

Updated Jun 21, 2026
One-click install
npx skills add https://github.com/du-qwq/Shader-Writing-Architecture-and-Specifications --skill unity-scene-du-qwq
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unity-scene
Source: https://github.com/du-qwq/Shader-Writing-Architecture-and-Specifications/tree/main/.agents/skills/unity-skills/skills/scene
Command: npx skills add https://github.com/du-qwq/Shader-Writing-Architecture-and-Specifications --skill unity-scene-du-qwq

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing Unity scenes manually through the editor is slow and hard to automate. This Skill lets you create, load, save, unload, and inspect Unity scenes programmatically, including multi-scene additive workflows and hierarchy queries. ## Core Features & Use Cases - Scene Lifecycle Management: Create new scenes, load scenes in single or additive mode, save, unload, and switch the active scene. - Scene Inspection: Query scene info, loaded scene lists, full hierarchy trees, and search GameObjects by name, tag, or component type. - Game View Screenshots: Capture the composited Game View frame (all cameras plus UI) at custom resolutions, saved under Assets/Screenshots/. - Use Case: While building a level, ask the AI to load your main scene additively with a UI overlay scene, verify the hierarchy structure, then capture a screenshot to confirm the result. ## Quick Start Load the scene at Assets/Scenes/MainMenu.unity and show me its hierarchy and current scene info.

Frequently Asked Questions about unity-scene

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

FAQPage Schema
How do I load a Unity scene additively?

Call scene_load with the scenePath parameter and set additive to true. This keeps the current scene loaded while adding the new one, which is useful for UI overlays and multi-scene editing workflows.

How to search GameObjects in a Unity scene by name or tag?

Use scene_find_objects with a namePattern, tag, or componentType filter to get matching GameObjects with their paths and instance IDs. For regex, layer, or path-based search, use gameobject_find instead.

Why does scene_create or scene_load return MODE_FORBIDDEN?

These skills are marked high risk because they create or overwrite entire scene files. They return MODE_FORBIDDEN in Approval or Auto modes and only run in Bypass mode or when explicitly allowlisted.

Does scene_screenshot capture the Scene view or Game view?

It captures the Game View, the final composited frame of all cameras plus UI. In Play mode this is the live runtime frame. For a single camera's off-screen render, use camera_screenshot instead.

How do I delete or rename a Unity scene file?

There is no scene_delete or scene_rename skill. Delete scene files with asset_delete and rename them with asset_move. To list all scene assets, use asset_find with the t:Scene filter.