unity-smart

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

Updated Jan 29, 2026
One-click install
npx skills add https://github.com/Dylan8865/FinalYearProject --skill unity-smart-dylan8865
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: unity-smart
Source: https://github.com/Dylan8865/FinalYearProject/tree/main/GameDev/Tester/.agents/skills/unity-skills/skills/smart
Command: npx skills add https://github.com/Dylan8865/FinalYearProject --skill unity-smart-dylan8865

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). - Automatic Layout & Alignment: Arrange selected objects into Linear, Grid, Circle, or Arc layouts, distribute them evenly, snap to grid, align to ground, or randomize transforms. - Auto Reference Binding: Automatically fill a List/Array field on a component with objects matching a tag or name, such as wiring all SpawnPoint-tagged objects into a GameManager. - Use Case: While building a level, ask to find every light above a brightness threshold, arrange the selected props in a circle, then bind all spawn points to the game controller in one pass. ## Quick Start Ask the assistant to find all Light components in the Unity scene with intensity greater than 2 and list them.

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 objects by component property value?▼

Use smart_scene_query with a component name, property name, comparison operator, and value. For example, query Light components where intensity is greater than 2 to get all matching objects in the scene.

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 sphere region. You can optionally filter results to only objects containing a specific component.

Can I automatically 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 matching a tag or name substring. Set appendMode to true to add to the existing list instead of replacing it.

Does this skill create new GameObjects in the scene?▼

No, these are query and layout tools, not creation tools. Use the gameobject module to create objects, and gameobject_find or scene_find_objects for simple name-based searches.

Why does smart_replace_objects return MODE_FORBIDDEN?▼

smart_replace_objects deletes and replaces original objects, so it is blocked in Approval and Auto modes. It only runs in Bypass mode or when explicitly allowlisted, since it performs destructive modify and delete operations.