skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
besty0728/unity-skills90 installs

unity-scene

Manage Unity scenes

How do I install this agent skill?

npx skills add https://github.com/besty0728/unity-skills --skill unity-scene
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    The skill provides a standardized interface for managing Unity scenes and capturing screenshots. It incorporates security best practices such as filename sanitization to prevent directory traversal and restricts file operations to the Unity project context. No malicious patterns or security risks were identified.

  • Socketpass

    No alerts

  • Snykpass

    Risk: LOW · No issues

  • Runlayerpass

    1 file scanned · No issues

What does this agent skill do?

Unity Scene Skills

Control Unity scenes, the containers that hold the GameObjects. Parameters come from the schema (GET /skills/schema?names=<skill>&wire=v2); execution and dryRun rules: root SKILL.md.

When to use

  • Opening, creating or saving scenes
  • Loading scenes additively or switching the active scene
  • Querying scene contents

Rules

  • scene_save overwrites the active scene's own file when scenePath is omitted. A different scenePath re-associates the active scene with that file (Save As); it does not copy. An untitled scene has no path, so it needs scenePath.
  • scene_save undo restores the on-disk .unity file when the scene is closed. While the scene is open, undo does not rewrite the file; it marks the scene dirty, so save again to apply it.
  • scene_save fails with SEMANTIC_INVALID during Play Mode, with a suggested editor_stop retry. Exit Play Mode first.
  • scene_create, scene_load and scene_save are high-risk writes. Other scene skills that modify state are gated by the schema's approvalBehavior.
  • scene_screenshot captures the Game View (all cameras and UI; the live runtime frame in Play Mode), not the Scene view. For one Game Camera use camera camera_screenshot.
  • For the detailed hierarchy tree or statistics, use the perception module (hierarchy_describe, scene_summarize).
  • DontDestroyOnLoad objects appear in Play Mode as a pseudo-scene. They are found by gameobject_find, but the pseudo-scene cannot be unloaded or activated.

Pitfalls

  • scene_delete and scene_rename do not exist. Delete scene files with asset_delete and rename them with asset_move.
  • scene_list does not exist. Use scene_get_loaded for loaded scenes, or asset_find with t:Scene for all scene assets.
  • scene_find_objects is a plain name, tag or component filter. For regex, layer or path search use gameobject_find.

Skills

scene_create

Create a new empty scene.

ParameterTypeRequiredDescription
scenePathstringYesPath of the new scene, e.g. "Assets/Scenes/MyScene.unity"

scene_load

Load a scene.

ParameterTypeRequiredDefaultDescription
scenePathstringYes-Scene asset path
additiveboolNofalsetrue keeps the loaded scenes open (OpenSceneMode.Additive); false closes them first (Single)

scene_save

Save the active scene.

ParameterTypeRequiredDescription
scenePathstringNoOmit to overwrite the active scene's own file. A different path re-associates the scene with that file (Save As). Needed for an untitled scene.

scene_get_info

Get information about the active scene.

Parameters: none.

Returns: {sceneName, scenePath, isDirty, rootObjectCount, rootObjects: [{name, entityId, instanceId, childCount}]}. childCount lets you decide which roots are worth descending into before a hierarchy call.

scene_get_hierarchy

Get the active scene's hierarchy tree, depth-limited.

ParameterTypeRequiredDefaultDescription
maxDepthintNo3Maximum depth to expand

Returns: {sceneName, hierarchy: [node, ...]}. Each node is {name, scene, entityId, instanceId, components: [type, ...], childCount, children}. scene is the owning scene's name.

In Play Mode, roots of the DontDestroyOnLoad pseudo-scene follow the active-scene nodes, marked scene: "DontDestroyOnLoad".

childCount is always the real number of children, whatever maxDepth is. children is null once the depth limit is reached:

childCountchildrenMeaning
0nullGenuine leaf
> 0nullClipped by maxDepth; children exist but were not returned
> 0arrayExpanded at this level

Never read children: null as "empty". To see what is below a clipped node, call again with a larger maxDepth (the default is 3), or query that subtree with gameobject_find.

scene_screenshot

Capture the Game View: the final composited frame of all cameras and UI.

ParameterTypeRequiredDefaultDescription
filenamestringNo"screenshot.png"Bare filename, no path separators; saved under Assets/Screenshots/
widthintNo1920Image width
heightintNo1080Image height
returnImageboolNofalseAlso return a PNG as base64 in imageBase64, for clients without filesystem access
maxDimensionintNo1280Used only with returnImage=true. Downscales the returned image (not the saved file) so its longer edge is at most this value. Clamped to 256-4096.

Returns: {success, path, width, height, isPlaying, note, imageBase64, imageWidth, imageHeight, imageBytes}. isPlaying tells a live Play Mode frame from a static Edit-mode frame. The four image* fields appear only with returnImage=true. A base64 payload over 8 MB returns an error asking for a smaller maxDimension; the file at path is still saved.

The PNG is written about one frame later. If reading path at once fails, wait about 200 ms and retry. returnImage does not read that file. It makes a separate synchronous capture of the current Game View backbuffer, so the returned image can be a moment older than the file.

A local agent that can read files should omit returnImage and read the PNG at path, which costs fewer tokens.

scene_get_loaded

List all loaded scenes.

Parameters: none.

Returns: {success, count, scenes: [{name, path, isLoaded, isDirty, isActive, rootCount, isPseudoScene}]}. In Play Mode the DontDestroyOnLoad pseudo-scene (isPseudoScene: true, empty path) is appended when it has root objects.

scene_unload

Unload a loaded scene (additive).

ParameterTypeRequiredDescription
sceneNamestringYesName of the scene to unload

scene_set_active

Set the active scene for multi-scene editing.

ParameterTypeRequiredDescription
sceneNamestringYesName of the scene to make active

scene_find_objects

Search GameObjects by name, tag or component type across the scene.

ParameterTypeRequiredDefaultDescription
namePatternstringNo-Case-insensitive substring, not a wildcard or regex
tagstringNo-Tag filter; a tag not defined in Tags & Layers is rejected
componentTypestringNo-Component type filter; an unknown type is rejected
limitintNo50Max objects returned

Returns: {success, count, totalMatched, truncated, objects: [{name, path, instanceId, active, tag}]}. count is the number returned (at most limit); totalMatched counts every match; truncated is true when limit cut the list. Router paging (pageOffset / pageLimit) pages objects and adds its own totalCount and limit.

Errors

Transport-level codes (COMPILING, RATE_LIMIT and others): error codes.

ErrorTriggerFix
TARGET_NOT_FOUNDThe scene is not found or not loaded (Scene not found, Scene is not loaded).Check the path with asset_find, or list loaded scenes with scene_get_loaded.
MISSING_PARAMscenePath is missing for scene_create, or the active scene has no save path.Pass scenePath, or save the scene once first.
SEMANTIC_INVALIDAn unknown tag or component type for scene_find_objects; scene_save during Play Mode.Use a valid name, consider gameobject_find, or run editor_stop first.
SKILL_ERRORA state constraint blocked the call, such as unloading the only loaded scene.Keep at least one scene loaded.

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/besty0728/unity-skills/unity-scene">View unity-scene on skillZs</a>