gameobject-find

Locate GameObjects by instanceID, path, or name in Unity prefabs or scenes.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/igot-ai/os-twin --skill gameobject-find-igot-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gameobject-find
Source: https://github.com/igot-ai/os-twin/tree/main/.agents/skills/roles/game-engineer/develop-unity-ui/references/gameobject-find
Command: npx skills add https://github.com/igot-ai/os-twin --skill gameobject-find-igot-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Finds specific GameObject by provided information in opened Prefab or in a Scene. First it looks for the opened Prefab, if any Prefab is opened it looks only there ignoring a scene. If no opened Prefab it looks into current active scene. Returns GameObject information and its children. Also, it returns Components preview just for the target GameObject.

Core Features & Use Cases

  • Locate a GameObject by reference (instanceID, path, or name) in the opened Prefab or active Scene, preferring opened Prefab.
  • Return a structured payload including the GameObject reference, editable data, 3D bounds, hierarchy metadata, and a shallow list of attached components.
  • Use Case: In a Unity MCP workflow, quickly locate an object and inspect its components without manually navigating the scene hierarchy.

Quick Start

Locate a target GameObject by reference in the opened Prefab or active Scene and return its information.

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 or prefab?

To locate a GameObject in Unity, provide a reference like instanceID, path, or name. The search prioritizes an opened Prefab, falling back to the active Scene, and returns structured metadata including bounds, hierarchy, and components.

What information does a Unity GameObject lookup return?

A GameObject lookup returns a structured payload containing the object reference, editable data, 3D bounds, hierarchy metadata, and a shallow list of attached components for the target object and its children.

Can I search for Unity scene objects by instanceID or path?

Yes, you can search for Unity scene or prefab objects using instanceID, path, or name. If a Prefab is opened, the search is restricted to that prefab, otherwise it queries the active scene.

Does Unity GameObject lookup work with both prefabs and scenes?

Yes, Unity GameObject lookup works with both prefabs and scenes. It automatically checks for an opened prefab first and ignores the active scene, otherwise it searches the active scene and returns the matching object data.

Why does my GameObject search ignore the active Unity scene?

A GameObject search ignores the active Unity scene when a prefab is currently opened, because the lookup logic explicitly prioritizes the opened prefab and restricts the search scope to that prefab only.

What's the best way to inspect Unity GameObject components without navigating the hierarchy?

The best way to inspect Unity GameObject components without manual navigation is using a deterministic lookup by name, path, or instanceID, which returns a shallow component list and hierarchy metadata directly in a structured payload.