unity-scene

Manage Unity scenes including loading, saving, hierarchy queries, and screenshots.

Updated Aug 18, 2026
One-click install
npx skills add https://github.com/ethanJPope/Our-Main-Hackathon-Game --skill unity-scene-ethanjpope
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unity-scene
Source: https://github.com/ethanJPope/Our-Main-Hackathon-Game/tree/main/.agents/skills/unity-skills/skills/scene
Command: npx skills add https://github.com/ethanJPope/Our-Main-Hackathon-Game --skill unity-scene-ethanjpope

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Working with Unity scenes through an editor UI is slow to automate: opening, saving, additively loading, and inspecting scene contents all require manual clicks. This Skill exposes scene operations as callable functions so an AI agent can create, load, save, query, and screenshot Unity scenes programmatically. ## Core Features & Use Cases - Scene lifecycle control: Create new scenes, load scenes (single or additive), save the current scene, unload additive scenes, and switch the active scene for multi-scene editing. - Scene inspection: Query current scene info, retrieve a depth-limited hierarchy tree with component and child-count metadata, list all loaded scenes, and find GameObjects by name, tag, or component type. - Game View screenshots: Capture the composited Game View frame to Assets/Screenshots/, with optional base64 return for remote clients without filesystem access. - Use Case: While building a level, ask the agent to load Assets/Scenes/Level1.unity additively, set it active, verify the hierarchy with scene_get_hierarchy, then save and capture a screenshot to confirm the result. ## Quick Start Ask the agent to load the scene at Assets/Scenes/MainMenu.unity, show the current scene hierarchy, and save the scene afterward.

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 from a script or agent?

Call scene_load with the scenePath parameter and set additive to true, which keeps the current scene loaded alongside the new one. This is the standard approach for UI overlays and multi-scene editing setups.

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 advanced searches using regex, layers, or full paths, use gameobject_find instead.

Why does scene_get_hierarchy show children as null for some nodes?

A null children field with childCount greater than zero means the tree was truncated at the maxDepth limit, which defaults to 3. Re-call with a larger maxDepth or query that subtree directly to see the hidden nodes.

Does scene_screenshot capture the Scene view or Game view?

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

Why does scene_create or scene_load return MODE_FORBIDDEN?

These skills are marked high risk because they switch or overwrite entire scene files, so they are blocked in Approval and Auto modes. They only run in Bypass mode or when explicitly allowlisted.

Can I delete or rename a Unity scene with this skill?

No, scene_delete and scene_rename do not exist. Delete scene files with asset_delete and rename them with asset_move from the asset module.