object-get-data

Read serialized fields and properties from UnityEngine.Object instances with path-scoped queries.

Updated Jul 20, 2026
One-click install
npx skills add https://github.com/PMK95/GridSquad --skill object-get-data-pmk95
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: object-get-data
Source: https://github.com/PMK95/GridSquad/tree/main/GridSquadUnity/.agents/skills/object-get-data
Command: npx skills add https://github.com/PMK95/GridSquad --skill object-get-data-pmk95

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires unity-mcp-cli.

What problem does it solve? Inspecting the internal state of Unity objects (GameObjects, Components, Assets) from an AI or CLI workflow is difficult without a structured reflection API, and dumping entire objects wastes tokens when you only need a few fields. ## Core Features & Use Cases - Full Object Serialization: Returns all serializable fields and properties of any UnityEngine.Object as a structured SerializedMember tree. - Path-Scoped Reads: Use the paths parameter to read only specific fields, nested members, array elements, or dictionary entries, reducing token usage. - View Queries: Use viewQuery to navigate to a subtree and filter by name regex, max depth, or type for targeted inspection. - Use Case: While debugging a scene, ask the AI to read only the transform/localPosition and health field of a specific enemy Component instead of serializing the entire object. ## Quick Start Ask the AI to get the serialized data of a Unity object by its instanceID, optionally limiting the read to specific field paths.

Frequently Asked Questions about object-get-data

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

FAQPage Schema
How do I read serialized data from a Unity object via CLI?▼

Run unity-mcp-cli run-tool object-get-data with an input JSON containing the objectRef instanceID. The tool returns the object's fields and properties as a structured SerializedMember tree.

How to read only specific fields of a Unity object?▼

Pass the paths parameter with a list of paths like 'fieldName', 'nested/field', 'arrayField/[i]', or 'dictField/[key]'. Only the listed members are read via Reflector.TryReadAt, which reduces token usage.

What is the difference between paths and viewQuery parameters?▼

The paths parameter reads individually listed fields at any depth, while viewQuery navigates to a subtree and filters by name regex, MaxDepth, and TypeFilter. The two parameters are mutually exclusive.

Can object-get-data modify Unity object values?▼

No, this tool is read-only and only returns serialized data. To write values back to the object, use the companion object-modify tool as directed in the documentation.

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 instead.