skills.rest
pikachu0310
pikachu0310COMMUNITY
Explore all skills by this author →
Website𝕏@pikachu0310mainGitHub

unity-scene

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

Updated Aug 31, 2026
Search Tags:#game development#unity#screenshot#hierarchy#scene management#editor automation#additive loading
One-click install
npx skills add https://github.com/pikachu0310/codex-agent-ops-public --skill unity-scene-pikachu0310
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: unity-scene
Source: https://github.com/pikachu0310/codex-agent-ops-public/tree/main/.agents/skills/unity-skills/skills/scene
Command: npx skills add https://github.com/pikachu0310/codex-agent-ops-public --skill unity-scene-pikachu0310

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing Unity scenes manually through the editor is slow when automating level setup, multi-scene workflows, or scene inspection. 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 (including additive loading for multi-scene setups), save the current scene, unload additive scenes, and switch the active scene. - Scene Inspection: Query current scene info, retrieve a depth-limited hierarchy tree with component and child-count data, list all loaded scenes, and search GameObjects by name, tag, or component type. - Game View Screenshots: Capture the composited Game View frame to a PNG under Assets/Screenshots/, optionally returning a downscaled base64 image for remote clients without filesystem access. - Use Case: While building a level, ask the agent to load the 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 then show me its hierarchy three levels deep.

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?▼

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 the standard approach for UI overlays and multi-scene editing.

How to get the Unity scene hierarchy programmatically?▼

Use scene_get_hierarchy with an optional maxDepth parameter, which defaults to 3. Each node returns name, entityId, components, childCount, and children; a null children array with childCount above zero means the tree was truncated by the depth limit.

Why does scene_create or scene_load return MODE_FORBIDDEN?▼

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

Can I capture a Unity Game View screenshot without filesystem access?▼

Yes, call scene_screenshot with returnImage set to true to receive a base64-encoded PNG in the response. Use maxDimension to downscale the returned image, since payloads over 8MB are rejected.

What is the difference between scene_screenshot and camera_screenshot?▼

scene_screenshot captures the final composited Game View including all cameras and UI, which in Play mode is the live runtime frame. camera_screenshot renders a single Game Camera off-screen instead.

How do I delete or rename a Unity scene asset?▼

There are no scene_delete or scene_rename skills. Delete scene files with asset_delete and rename them with asset_move, since scenes are managed as regular assets for those operations.

Related Skills

Explore More Software Engineering Skills→
ishaansingh-aiishaansingh-ai

scene-set-active

Sets a specified opened Unity scene as the active scene via unity-mcp-cli.

Community
Basic
ishaansingh-aiishaansingh-ai

gameobject-duplicate

Duplicates GameObjects in an opened Prefab or active Unity Scene.

Community
Basic
mandexonlamandexonla

unity-perception

Analyze active Unity scenes to generate summaries, hierarchy snapshots, and dependency reports.

Community
Advanced
infotechsrealminfotechsrealm

scene-create

Automate Unity scene creation with custom setups and additive modes.

Community
Basic