skills.rest
PMK95
PMK95COMMUNITY
Explore all skills by this author →
GitHub

gameobject-find

Find a GameObject in an opened Unity Prefab or active Scene with optional data, components, bounds, and hierarchy.

Updated Jul 20, 2026
Search Tags:#unity#mcp#find#scene#hierarchy#prefab#gameobject
One-click install
npx skills add https://github.com/PMK95/GridSquad --skill gameobject-find-pmk95
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gameobject-find
Source: https://github.com/PMK95/GridSquad/tree/main/GridSquadUnity/.agents/skills/gameobject-find
Command: npx skills add https://github.com/PMK95/GridSquad --skill gameobject-find-pmk95

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires unity-mcp-cli.

What problem does it solve? Locating a specific GameObject inside a Unity Prefab or active Scene and inspecting its data, components, bounds, and hierarchy normally requires manual editor navigation, which is slow and hard to automate from an AI or CLI workflow. ## Core Features & Use Cases - Targeted GameObject Lookup: Find a GameObject by instanceID, hierarchy path, name, or asset reference, preferring the opened Prefab over the active Scene. - Configurable Detail Toggles: Optionally include editable data, component previews, 3D bounds, and hierarchy metadata with a configurable depth. - Token-Saving Scoped Reads: Use paths or viewQuery to read only specific fields or filtered subtrees instead of full serialization. - Use Case: Ask the agent to find the 'Player' GameObject in the current scene and return only its transform fields via a path-scoped read, keeping the response small. ## Quick Start Ask the agent to find the GameObject named Player in the active scene and include its components and hierarchy one level deep.

Frequently Asked Questions about gameobject-find

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find a GameObject in a Unity scene from the command line?▼

Run unity-mcp-cli with the gameobject-find tool and pass a gameObjectRef containing an instanceID, hierarchy path, or name. The tool searches the opened Prefab first, then the active Scene, and returns the GameObject with its children.

How do I reduce the response size when inspecting a Unity GameObject?▼

Use the paths parameter to read only specific fields like 'nested/field' or 'arrayField/[i]', or use viewQuery to filter by name regex, max depth, or type. These scoped reads replace the full includeData serialization and are mutually exclusive.

Does gameobject-find search Prefabs or Scenes first?▼

It searches the opened Prefab first. If any Prefab is open in the editor, the Scene is ignored entirely; only when no Prefab is open does it search the current active Scene.

What is the difference between paths and viewQuery in gameobject-find?▼

paths reads a list of individual field paths via Reflector.TryReadAt, while viewQuery navigates to a subtree and filters by name regex, max depth, or type via Reflector.View. Only one of the two can be supplied per call.

Why is unity-mcp-cli not found when running the tool?▼

The CLI is not installed or not on your PATH. Install it globally with npm install -g unity-mcp-cli, or invoke it through npx unity-mcp-cli, then retry the run-tool command.

Related Skills

Explore More Software Engineering Skills→
ishaansingh-aiishaansingh-ai

assets-prefab-create

Creates a Unity prefab asset from a GameObject in the active scene.

Community
Basic
Silac1995Silac1995

gameobject-component-modify

Modify a specific Component on a GameObject in Prefabs or Scenes using a componentDiff payload.

Community
Intermediate
lightvu25lightvu25

gameobject-component-add

Add namespace-qualified Unity components to GameObjects in Prefabs or active Scenes.

Community
Intermediate
sprillionsprillion

gameobject-component-add

Attaches components to a GameObject by fully qualified type name.

Community
Intermediate