unity-smart

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

Updated Oct 13, 2025
One-click install
npx skills add https://github.com/Darth-Carrotpie/ProxyCore --skill unity-smart-darth-carrotpie
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: unity-smart
Source: https://github.com/Darth-Carrotpie/ProxyCore/tree/main/.agents/skills/unity-skills/skills/smart
Command: npx skills add https://github.com/Darth-Carrotpie/ProxyCore --skill unity-smart-darth-carrotpie

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 query scene 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 & Transform: 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-Binding & Selection: Fill a List/Array field on a component with objects matched by tag or name, select all objects with a given component, or replace selected objects with a prefab while preserving transforms. - Use Case: Select dozens of scattered props, then run a Circle layout with radius 5 and lookAtCenter enabled to instantly form a staged arena arrangement. ## Quick Start Ask the agent to find all Light components in the Unity scene whose intensity is greater than 2 using a smart scene query.

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, for example finding all Light components with intensity greater than 2. It supports ==, !=, >, <, >=, <=, and contains operators with a configurable result limit.

How to arrange selected objects in a circle in Unity?▼

Select the objects in the Hierarchy, then call smart_scene_layout with layoutType set to Circle and spacing as the radius. You can also enable lookAtCenter so each object rotates to face the center of the arrangement.

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

Yes, smart_reference_bind fills a List or Array field on a target component with objects matched by tag or name substring. Set appendMode to true to add to existing entries instead of replacing them.

Does smart_scene_query support natural language query strings?▼

No, the query parameter is an unsupported shorthand and returns a guidance error if used alone. You must specify componentName and propertyName explicitly with an operator and value.

Why does smart_replace_objects return MODE_FORBIDDEN?▼

smart_replace_objects is flagged NeverInSemi because it deletes original objects, so it returns MODE_FORBIDDEN in Approval or Auto modes. It only runs in Bypass mode or when explicitly allowlisted.

What is the difference between smart_scene_query and gameobject_find?▼

smart_scene_query handles complex SQL-like queries filtering by component property values, while gameobject_find or scene_find_objects are better for simple name-based object searches. Smart skills do not create objects; use the gameobject module for creation.