unity-scene

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

2|Updated May 18, 2026
One-click install
npx skills add https://github.com/pcone-mm/NewFPG --skill unity-scene-pcone-mm
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unity-scene
Source: https://github.com/pcone-mm/NewFPG/tree/main/.agents/skills/unity-skills/skills/scene
Command: npx skills add https://github.com/pcone-mm/NewFPG --skill unity-scene-pcone-mm

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing Unity scenes manually through the editor is slow and hard to automate. This Skill lets an AI agent programmatically create, load (single or additive), save, unload, and switch scenes, as well as query scene contents and capture Game View screenshots. ## Core Features & Use Cases - Scene Lifecycle Control: Create new scenes, load scenes single or additively for multi-scene setups, save, unload, and set the active scene. - Scene Inspection: Query scene info, full hierarchy trees, loaded scene lists, and search GameObjects by name, tag, or component type. - Game View Screenshots: Capture the composited Game View frame to disk or as base64, useful for visual verification in Play or Edit mode. - Use Case: Ask the agent to open "Assets/Scenes/Level1.unity", additively load a UI scene, verify the hierarchy, then save and take a screenshot to confirm the result. ## Quick Start Open the scene at Assets/Scenes/MainMenu.unity, show me its hierarchy, and save it after making changes.

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 an AI 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 multi-scene setups like UI overlays.

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

Use scene_find_objects with a namePattern, tag, or componentType filter and an optional result limit. For advanced searches using regex, layers, or paths, use gameobject_find instead.

Why does scene_create or scene_load return MODE_FORBIDDEN?

These skills are marked high risk because they replace or overwrite entire scene files, so they are blocked in Approval and Auto modes. They 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, which is the live runtime image in Play mode. For a single camera's off-screen render, use camera_screenshot instead.

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, since scenes are managed as assets on disk.