skills.rest
ishaansingh-ai
ishaansingh-aiCOMMUNITY
Explore all skills by this author →
Website𝕏@IshaanSing62020GitHub

gameobject-find

Finds GameObjects in an opened Unity Prefab or active scene and returns hierarchy and component data.

Updated May 28, 2026
Search Tags:#unity#find#scene#hierarchy#prefab#gameobject#unity-mcp-cli
One-click install
npx skills add https://github.com/ishaansingh-ai/Mechanical-2D --skill gameobject-find-ishaansingh-ai
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gameobject-find
Source: https://github.com/ishaansingh-ai/Mechanical-2D/tree/main/.claude/skills/gameobject-find
Command: npx skills add https://github.com/ishaansingh-ai/Mechanical-2D --skill gameobject-find-ishaansingh-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires unity-mcp-cli.

What problem does it solve? Locating a specific GameObject inside a large Unity scene or Prefab hierarchy is slow and error-prone when done manually, especially when you also need its components, bounds, or child structure for further automation. ## Core Features & Use Cases - Targeted GameObject Lookup: Find a GameObject by instanceID, hierarchy path, name, asset path, or GUID, searching the opened Prefab first and falling back to the active scene. - Rich Optional Metadata: Optionally include editable data (tag, layer), attached component previews, 3D bounds, and hierarchy metadata down to a configurable depth. - Use Case: While automating a Unity scene edit, you need the instanceID and component list of the 'Player/Hand' object before modifying it. Run the find tool with includeComponents and hierarchyDepth to get everything in one call. ## Quick Start Ask the AI to find the GameObject named 'Player' in the current Unity scene and include its components and hierarchy.

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 run-tool gameobject-find with a JSON input containing a gameObjectRef. You can identify the object by instanceID, hierarchy path, or name, and the tool returns its data, children, and component preview.

How do I search for a GameObject inside an opened Prefab instead of the scene?▼

The tool automatically prioritizes the opened Prefab. If any Prefab is open in Unity, the search runs only inside that Prefab; otherwise it searches the current active scene, so no extra parameter is needed.

What reference types can I use to locate a Unity GameObject?▼

The gameObjectRef accepts instanceID (highest priority), hierarchy path such as 'character/hand/finger', name, assetType, assetPath starting with 'Assets/', or assetGuid. instanceID is the recommended identifier.

Can I get the components attached to a found GameObject?▼

Yes, set includeComponents to true to receive a shallow preview of attached components including instanceID, type name, and enabled state. Component data is read-only; use a component modification tool to change values.

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 prefix commands with npx unity-mcp-cli, then retry the gameobject-find call.

Related Skills

Explore More Software Engineering Skills→
AdielMagAdielMag

assets-prefab-open

Opens the Unity prefab edit stage for a prefab instance or prefab asset GameObject.

Community
Basic
ishaansingh-aiishaansingh-ai

gameobject-modify

Modify GameObject fields and properties in Unity Prefabs and Scenes.

Community
Intermediate
sprillionsprillion

gameobject-duplicate

Duplicate target GameObjects in an opened Prefab or active Scene.

Community
Intermediate
ishaansingh-aiishaansingh-ai

gameobject-create

Creates a new GameObject in an open Unity Prefab or Scene with optional transform settings.

Community
Basic