unity-smart

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

Updated Jun 21, 2026
One-click install
npx skills add https://github.com/du-qwq/Shader-Writing-Architecture-and-Specifications --skill unity-smart-du-qwq
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: unity-smart
Source: https://github.com/du-qwq/Shader-Writing-Architecture-and-Specifications/tree/main/.agents/skills/unity-skills/skills/smart
Command: npx skills add https://github.com/du-qwq/Shader-Writing-Architecture-and-Specifications --skill unity-smart-du-qwq

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Manually locating, arranging, and wiring objects in large Unity scenes is slow and error-prone. This Skill automates scene queries, layout arrangement, and reference binding so repetitive scene-editing work happens in one command. ## 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/box around a coordinate). - Automatic Layout & Alignment: Arrange selected objects in Linear, Grid, Circle, or Arc patterns, distribute them evenly, snap to grid, align to ground, or randomize transforms. - Auto Reference Binding: Fill a component's List/Array field with objects matched by tag or name, e.g., populate GameManager.spawns with all SpawnPoint-tagged objects. - Use Case: A level designer selects 20 props and asks to arrange them in a circle with radius 5, then aligns them to the terrain — done in two calls instead of manual dragging. ## Quick Start Ask the AI to find all Light components in the Unity scene whose intensity is greater than 2 and list the matching objects.

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 matching objects, such as all Lights with intensity greater than 2. It supports ==, !=, >, <, >=, <=, and contains operators with a configurable result limit.

How to automatically arrange objects in a Unity scene?▼

Use smart_scene_layout on selected objects with a layoutType of Linear, Grid, Circle, or Arc, plus spacing and axis parameters. You can also use smart_distribute to space objects evenly or smart_snap_to_grid for grid alignment.

Can I search Unity objects within a specific area or radius?▼

Yes, smart_scene_query_spatial finds objects inside a sphere defined by center coordinates and radius, optionally filtered by component type. It returns the matching objects with count, center, and radius metadata.

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

Use smart_reference_bind with the target GameObject, component, and field name, plus a sourceTag or sourceName filter. It fills the List or Array field with all matching objects, with an appendMode option to preserve existing entries.

Why does smart_replace_objects return MODE_FORBIDDEN?▼

smart_replace_objects is flagged as a high-risk skill because it deletes original objects during replacement. It returns MODE_FORBIDDEN under Approval or Auto modes and only runs in Bypass mode or when explicitly allowlisted.

What are the limitations of Unity smart scene query skills?▼

These skills query and arrange existing objects but cannot create new ones; use the gameobject module for creation. Layout, distribute, and align operations also require objects to be pre-selected in the Hierarchy before execution.