unity-smart
AI-powered scene queries, layout and auto-binding. AI
Install / Use
npx skills add Besty0728/Unity-Skills --skill smartInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Development & EngineeringSupported Platforms
Tags
Our assessment of unity-smart
unity-smart scores 84/100 on our quality scale, 2890th of 4,698 Development & Engineering skills we index.
Its SKILL.md is 6.9 KB long, well organised into 18 sections with 3 code examples: a thorough specification that gives an agent plenty to work with.
With 1,781 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so unity-smart is actively maintained.
- Our last check on 2026-10-14 found the source still online.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-10-01. Automated pattern scan on 2026-10-01. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
unity-smart compared with similar skills
All 4 of these similar skills score higher than unity-smart; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| unity-smart (this skill)by Besty0728 | 84 | 1.8k | 53d ago | SKILL.md |
| taste-skillby Leonxlnx | 100 | 116.8k | 8d ago | CLAUDE.md |
| ai-job-searchby ai-job-search-dev | 100 | 72.1k | today | CLAUDE.md |
| claude-howtoby luongnv89 | 100 | 47.3k | 2d ago | CLAUDE.md |
| lobehubby lobehub | 100 | 85.6k | today | MCP Server |
Frequently asked questions
- How do I install unity-smart?
- Run
npx skills add Besty0728/Unity-Skills --skill unity-smart. The install tabs above show the steps for each supported agent. - Which AI agents does unity-smart work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is unity-smart safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is unity-smart still maintained?
- The repository was last updated about 2 months ago, so unity-smart is actively maintained.
Skill content
View source on GitHubname: unity-smart description: AI-powered scene queries, layout and auto-binding. AI
Before calling any skill in this module: if you are about to call a skill with parameters guessed from its name or description, STOP — read this file (or fetch its schema via
GET /skills/recommend?includeSchema=true) first. If you already have the parameter definitions from recommend/schema, you may proceed straight to dryRun.
Triggers
- Querying scene objects by condition or proximity
- Auto-arranging objects
- Auto-wiring references
- 按条件或邻近关系查询场景对象、自动排布对象、自动连线引用
Unity Smart Skills
Operating Mode
- Approval:本模块 Mixed —— 只读查询 skill
smart_scene_query/smart_scene_query_spatial(标ReadOnly = true,Mode = SkillMode.SemiAuto)可直接执行;其余布局/绑定/变换类 skill (smart_scene_layout/smart_reference_bind/smart_align_to_ground/smart_distribute/smart_snap_to_grid/smart_randomize_transform/smart_select_by_component) 为SkillMode.FullAuto,需用户 grant 单次执行返结果。 - Auto / Bypass:直接执行。
- 含 NeverInSemi 高危 skill:
smart_replace_objects(Operation.Modify|Delete,会替换并删除原对象)。该 skill 在 Approval/Auto 下返MODE_FORBIDDEN,仅 Bypass 或 Allowlist 命中可调。
DO NOT (common hallucinations):
smart_create/smart_builddo not exist → smart skills are query/layout tools, not creation toolssmart_search/smart_querydo not exist → usesmart_scene_query(component property filters) orsmart_scene_query_spatial(spatial region filters)smart_movedoes not exist → usesmart_snap_to_gridorsmart_align_to_ground
Routing:
- For creating objects → use
gameobjectmodule - For simple object search → use
gameobject_findorscene_find_objects - For complex scene queries (SQL-like) →
smart_scene_query(this module)
Skills
smart_scene_query
Find objects based on component property values (SQL-like).
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| componentName | string | Yes | - | Component type (Light, Camera, MeshRenderer) |
| propertyName | string | Yes | - | Property to query (intensity, enabled, etc.) |
| op | string | No | "==" | ==, !=, >, <, >=, <=, contains |
| value | string | No | null | Value to compare |
| limit | int | No | 50 | Max results |
| query | string | No | null | Unsupported shorthand; if provided alone returns a guidance error |
Example:
# Find all lights with intensity > 2
call_skill("smart_scene_query", componentName="Light", propertyName="intensity", op=">", value="2")
smart_scene_layout
Organize selected objects into a layout.
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| layoutType | string | No | "Linear" | Linear, Grid, Circle, Arc |
| axis | string | No | "X" | X, Y, Z, -X, -Y, -Z |
| spacing | float | No | 2.0 | Space between items (or radius) |
| columns | int | No | 3 | For Grid layout |
| arcAngle | float | No | 180 | For Arc layout (degrees) |
| lookAtCenter | bool | No | false | Rotate to face center |
Example:
# Arrange selected objects in a circle
call_skill("smart_scene_layout", layoutType="Circle", spacing=5)
smart_reference_bind
Auto-fill a List/Array field with matching objects.
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| targetName | string | Yes | - | Target GameObject |
| componentName | string | Yes | - | Component on target |
| fieldName | string | Yes | - | Field to fill |
| sourceTag | string | No | null | Find by tag |
| sourceName | string | No | null | Find by name contains |
| appendMode | bool | No | false | Append instead of replace |
Example:
# Fill GameManager.spawns with all SpawnPoint tagged objects
call_skill("smart_reference_bind", targetName="GameManager", componentName="GameController", fieldName="spawns", sourceTag="SpawnPoint")
smart_scene_query_spatial
Find objects within a sphere/box region, optionally filtered by component.
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| x | float | Yes | - | Center X coordinate |
| y | float | Yes | - | Center Y coordinate |
| z | float | Yes | - | Center Z coordinate |
| radius | float | No | 10 | Search sphere radius |
| componentFilter | string | No | null | Only include objects with this component |
| limit | int | No | 50 | Max results |
Returns: { success, count, center, radius, results }
smart_align_to_ground
Raycast selected objects downward to align them to the ground. Requires objects selected in Hierarchy first.
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| maxDistance | float | No | 100 | Maximum raycast distance |
| alignRotation | bool | No | false | Align rotation to surface normal |
Returns: { success, aligned, total }
smart_distribute
Evenly distribute selected objects between first and last positions. Requires at least 3 objects selected in Hierarchy first.
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| axis | string | No | "X" | X, Y, Z, -X, -Y, -Z |
Returns: { success, distributed, axis }
smart_snap_to_grid
Snap selected objects to a grid.
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| gridSize | float | No | 1 | Grid cell size |
Returns: { success, snapped, gridSize }
smart_randomize_transform
Randomize position/rotation/scale of selected objects within ranges.
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| posRange | float | No | 0 | Position randomization range |
| rotRange | float | No | 0 | Rotation randomization range (degrees) |
| scaleMin | float | No | 1 | Minimum uniform scale |
| scaleMax | float | No | 1 | Maximum uniform scale |
Returns: { success, randomized }
smart_replace_objects
Replace selected objects with a prefab (preserving transforms). Requires objects selected in Hierarchy first.
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| prefabPath | string | Yes | - | Asset path to the replacement prefab |
Returns: { success, replaced, prefab }
smart_select_by_component
Select all objects that have a specific component.
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| componentName | string | Yes | - | Component type name to search for |
Returns: { success, selected, component }
Exact Signatures
Exact names, parameters, defaults, and returns are defined by GET /skills/schema or unity_skills.get_skill_schema(), not by this file.
Related Skills
taste-skill
116.8kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
ai-job-search
72.1kThe job search that runs on your machine. AI job application framework built on Claude Code: evaluate postings, tailor CVs, write cover letters, prep interviews. Fork it and own it.
claude-howto
47.3kA visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates that bring immediate value.
lobehub
85.6k🤯 LobeHub - Super-Agents on Your Team. Add super-agents to the chats your team already uses.They take on work by themselves and get better every week.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
