unity-smart

Query, arrange, and auto-bind Unity scene objects using SQL-like and spatial filters.

Updated May 20, 2026
One-click install
npx skills add https://github.com/yuse168/Roomies --skill unity-smart-yuse168
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: unity-smart
Source: https://github.com/yuse168/Roomies/tree/main/.agents/skills/unity-skills/skills/smart
Command: npx skills add https://github.com/yuse168/Roomies --skill unity-smart-yuse168

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Manually locating, arranging, and wiring up objects in large Unity scenes is slow and error-prone. This Skill lets you find objects by component property values or spatial regions, auto-arrange selections into layouts, and auto-fill reference fields without clicking through the Hierarchy. ## Core Features & Use Cases - SQL-like Scene Queries: Find objects by component property conditions (e.g., all Lights with intensity > 2) or by spatial region (sphere radius around a point), with optional component filters. - Automatic Layout & Transforms: Arrange selected objects into Linear, Grid, Circle, or Arc layouts, distribute them evenly, snap to grid, align to ground via raycast, or randomize transforms. - Auto Reference Binding: Fill a List/Array field on a component with objects matched by tag or name, and batch-replace selected objects with a prefab while preserving transforms. - Use Case: You need to populate a GameController's spawn point list and tidy the scene. Query all objects tagged SpawnPoint, bind them to the spawns field automatically, then arrange the remaining props in a circle layout. ## Quick Start Ask the AI to find all Light components in the Unity scene with intensity greater than 2 and list the results.

Frequently Asked Questions about unity-smart

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

FAQPage Schema
How do I find Unity scene objects by component property value?▼

Use smart_scene_query with a componentName, propertyName, comparison operator, and value to find objects matching SQL-like conditions, such as all Light components with intensity greater than 2. Results are limited to 50 by default.

How to find GameObjects within a radius in a Unity scene?▼

Use smart_scene_query_spatial with center coordinates (x, y, z) and a radius to find objects inside a spherical region. You can optionally filter results to only objects containing a specific component via componentFilter.

Can this skill create new GameObjects in Unity?▼

No, this skill only queries, arranges, and binds existing scene objects; it has no creation capability. For creating objects, use the gameobject module, and for simple searches use gameobject_find or scene_find_objects.

How do I auto-fill a List field with tagged objects in Unity?▼

Use smart_reference_bind with the target GameObject name, component name, field name, and a sourceTag or sourceName to match objects. Set appendMode to true to add to the existing list instead of replacing it.

Why does smart_replace_objects return MODE_FORBIDDEN?▼

smart_replace_objects is flagged as a high-risk operation because it deletes original objects when replacing them with a prefab. It returns MODE_FORBIDDEN in Approval or Auto modes and only runs under Bypass mode or an explicit allowlist entry.

What are the limitations of the automatic layout tools?▼

Layout, distribute, snap, align, and randomize operations require objects to be pre-selected in the Hierarchy, and smart_distribute needs at least three selected objects. smart_align_to_ground depends on raycast hits within the maxDistance, defaulting to 100 units.