skills.rest
AdielMag
AdielMagCOMMUNITY
Explore all skills by this author →
GitHub

gameobject-find

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

Updated May 27, 2026
Search Tags:#game development#unity#find#prefab#gameobject#unity-mcp#scene hierarchy
One-click install
npx skills add https://github.com/AdielMag/ClashUp --skill gameobject-find-adielmag
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gameobject-find
Source: https://github.com/AdielMag/ClashUp/tree/main/client/ClashUp.Unity/.claude/skills/gameobject-find
Command: npx skills add https://github.com/AdielMag/ClashUp --skill gameobject-find-adielmag

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 editable data for further automation. ## 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. - Token-Saving Scoped Reads: Use paths or viewQuery to read only selected fields or a filtered subtree instead of a full recursive serialization. - Optional Detail Toggles: Include editable data, component previews, 3D bounds, and hierarchy metadata with configurable depth. - Use Case: While building a Unity gameplay feature, ask the AI to find the 'Player/Hand/Weapon' GameObject and return only its transform fields, so you can verify placement without dumping the entire scene hierarchy. ## Quick Start Ask the AI to find the GameObject named Player in the current Unity scene and include its components and one level of 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 gameObjectRef containing the instanceID, hierarchy path, or name. The tool searches the opened Prefab first, then the active Scene, and returns the GameObject with its children.

How can I reduce token usage when reading Unity GameObject data?▼

Pass the paths parameter to read only specific fields via Reflector.TryReadAt, or use viewQuery to filter by name regex, max depth, or type. Both replace the full recursive serialization that includeData would produce.

Does gameobject-find search prefabs or scenes first?▼

It searches the currently opened Prefab first and ignores the scene entirely while a Prefab is open. Only when no Prefab is open does it look in the active scene.

Can I use paths and viewQuery together in one call?▼

No, paths and viewQuery are mutually exclusive; supply at most one per call. Both override includeData and populate the Data field on the returned GameObjectData.

What should I do if unity-mcp-cli is not found?▼

Install it globally with npm install -g unity-mcp-cli, or invoke it via npx unity-mcp-cli. The unity-initial-setup skill covers detailed installation steps.

Related Skills

Explore More Software Engineering Skills→
igot-aiigot-ai

gameobject-duplicate

Duplicate target GameObjects in an opened Prefab or active Scene.

Official
Intermediate
sprillionsprillion

gameobject-component-modify

Modify component fields and properties on GameObjects in Prefabs or Scenes.

Community
Intermediate
Silac1995Silac1995

gameobject-find

Locate GameObjects in an open Prefab or active Scene and return structured data.

Community
Intermediate
hatayamahatayama
500

uloop-find-game-objects

Find Unity scene GameObjects by name, path, regex, component, tag, or layer.

Community
Intermediate