unity-smart

Query Unity scene objects by component properties and arrange them into layouts.

1|Updated Feb 28, 2026
One-click install
npx skills add https://github.com/muddyrain/valley-mas --skill unity-smart-muddyrain
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unity-smart
Source: https://github.com/muddyrain/valley-mas/tree/main/.codex/skills/unity-skills/skills/smart
Command: npx skills add https://github.com/muddyrain/valley-mas --skill unity-smart-muddyrain

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Unity projects often struggle to quickly locate objects by component properties, automatically arrange scene elements, and wire up references, leading to manual, repetitive work and error-prone setups.

Core Features & Use Cases

  • SQL-like queries to locate objects based on componentName, propertyName, op, and value, with optional limit.
  • Automatic spatial layout of selected objects in Linear, Grid, Circle, or Arc configurations, with adjustable axis and spacing.
  • Auto-binding of serialized references to target fields via the smart_reference_bind workflow, reducing manual linking.
  • Real-world scenario: find all point lights with intensity > 2, arrange them in a Circle around the scene center, and auto-bind their "spawns" array on the manager object.

Quick Start

Call smart_scene_query with a component name, property name, and value to locate objects, then apply smart_scene_layout to arrange them and smart_reference_bind to wire up references.

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 values instead of searching manually?

You can locate Unity scene objects by component properties using SQL-like queries that filter by componentName, propertyName, op, and value, returning matching results with an optional limit.

Can I automatically arrange selected Unity game objects into a grid or circle layout?

You can automatically arrange selected Unity objects into grid, circle, line, or arc layouts by specifying a layoutType with adjustable axis and spacing parameters.

What's the best way to auto-bind serialized references to target fields in Unity?

Auto-binding serialized references to target fields uses the smart_reference_bind workflow, requiring targetName and fieldName parameters to wire up connections and reduce manual linking errors.

Does AI-driven Unity scene management work in both editor and runtime contexts?

AI-driven Unity scene management supports safe execution in both editor and runtime contexts, applying guardrails to querying, layout, and binding operations.

How do I query point lights by intensity and arrange them around a scene center in Unity?

Query point lights by intensity using a component name and operator, then apply a circle layout to arrange the matching objects around a defined scene center with adjustable spacing.

Are there limitations when using SQL-like queries to locate Unity scene objects?

SQL-like queries for locating Unity scene objects require valid componentName, propertyName, op, and value parameters, relying on guardrails to ensure safe execution and prevent invalid filtering.