unity-scene

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

Updated Jan 29, 2026
One-click install
npx skills add https://github.com/Dylan8865/FinalYearProject --skill unity-scene-dylan8865
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: unity-scene
Source: https://github.com/Dylan8865/FinalYearProject/tree/main/GameDev/Tester/.agents/skills/unity-skills/skills/scene
Command: npx skills add https://github.com/Dylan8865/FinalYearProject --skill unity-scene-dylan8865

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing Unity scenes manually through the editor is slow when automating workflows; this Skill lets you programmatically create, load, save, unload, and inspect scenes and their contents from an AI-driven pipeline. ## Core Features & Use Cases - Scene Lifecycle Management: Create new scenes, load scenes in single or additive mode, save, unload, and switch the active scene for multi-scene editing. - Scene Inspection: Query scene info, loaded scene lists, full hierarchy trees, and search GameObjects by name, tag, or component type. - Game View Capture: Take screenshots of the composited Game View (all cameras plus UI), 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, 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_save return MODE_FORBIDDEN?▼

These skills are marked high risk because they create or overwrite entire scene files. They are blocked in Approval and 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 it is the live runtime frame; for a single camera 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, since scenes are treated as assets for file operations.