batihandev/unity-mcp-skills/smart

Unity Smart Skills

Overview

Query and layout tools for scene objects. Use to find objects by component property conditions, arrange objects spatially (grid, circle, line), or auto-wire serialized references between components.

Common Mistakes

DO NOT (common hallucinations):

• smart_create / smart_build do not exist → smart skills are query/layout tools, not creation tools
• smart_search / smart_query do not exist → use smart_scene_query (component property filters) or smart_scene_query_spatial (spatial region filters)
• smart_move does not exist → use smart_snap_to_grid or smart_align_to_ground

Routing:

• For creating objects → use gameobject module
• For simple object search → use gameobject_find or scene_find_objects
• For complex scene queries (SQL-like) → smart_scene_query (this module)

Skills

smart_scene_query

Find objects based on component property values (SQL-like).

Example: See `../../recipes/smart/<command>.md` for C# templates.

smart_scene_layout

Organize selected objects into a layout.

Example: See `../../recipes/smart/<command>.md` for C# templates.

smart_reference_bind

Auto-fill a List/Array field with matching objects.

Example: See `../../recipes/smart/<command>.md` for C# templates.

smart_scene_query_spatial

Find objects within a sphere/box region, optionally filtered by component.

Returns: { success, count, center, radius, results }

smart_align_to_ground

Raycast selected objects downward to align them to the ground. Requires objects selected in Hierarchy first.

Returns: { success, aligned, total }

smart_distribute

Evenly distribute selected objects between first and last positions. Requires at least 3 objects selected in Hierarchy first.

Returns: { success, distributed, axis }

smart_snap_to_grid

Snap selected objects to a grid.

Returns: { success, snapped, gridSize }

smart_randomize_transform

Randomize position/rotation/scale of selected objects within ranges.

Returns: { success, randomized }

smart_replace_objects

Replace selected objects with a prefab (preserving transforms). Requires objects selected in Hierarchy first.

Returns: { success, replaced, prefab }

smart_select_by_component

Select all objects that have a specific component.

Returns: { success, selected, component }

Example Usage

See `../../recipes/smart/<command>.md` for C# templates.

Recipe path rule: ../../recipes/smart/<command>.md