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.