SkillAgentSearch skills...

unity-validation

Validate project and scene health plus cleanup

Install / Use

npx skills add Besty0728/Unity-Skills --skill validation

Installs into whichever agent you are using.

About this skill
📄

SKILL.md

Installable skill definition

Quality Score

84/100

Supported Platforms

Universal

Tags

Our assessment of unity-validation

unity-validation scores 84/100 on our quality scale, 2891st of 4,698 Development & Engineering skills we index.

Its SKILL.md is 9.2 KB long, well organised into 27 sections with 2 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.

Substance
29/30
Structure
18/20
Description
8/15
Adoption
14/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated about 2 months ago, so unity-validation 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 found

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.

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-validation compared with similar skills

All 4 of these similar skills score higher than unity-validation; compare them before choosing.

SkillScoreStarsUpdatedFormat
unity-validation (this skill)by Besty0728841.8k53d agoSKILL.md
taste-skillby Leonxlnx100116.8k8d agoCLAUDE.md
ai-job-searchby ai-job-search-dev10072.1ktodayCLAUDE.md
claude-howtoby luongnv8910047.3k2d agoCLAUDE.md
lobehubby lobehub10085.6ktodayMCP Server

Frequently asked questions

How do I install unity-validation?
Run npx skills add Besty0728/Unity-Skills --skill unity-validation. The install tabs above show the steps for each supported agent.
Which AI agents does unity-validation 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-validation 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-validation still maintained?
The repository was last updated about 2 months ago, so unity-validation is actively maintained.

name: unity-validation description: Validate project and scene health plus cleanup

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

  • Checking broken or missing references
  • Validating scene/project integrity
  • Cleaning up before a build
  • 检查断裂或丢失引用、校验场景/项目完整性、构建前清理

Unity Validation Skills

Maintain project health - find problems, clean up, and validate your Unity project.

Operating Mode

  • Approval: 只读分析 skill(validate_scene / validate_find_missing_scripts / validate_find_unused_assets / validate_texture_sizes / validate_project_structure / validate_missing_references / validate_mesh_collider_convex / validate_shader_errors,标 SkillMode.SemiAuto)直接执行;含 Delete 的 skill(validate_cleanup_empty_folders 标 Analyze | Delete、validate_fix_missing_scripts 标 Execute | Delete,默认 SkillMode.FullAuto)需用户 grant。
  • Auto / Bypass: 直接执行。
  • 本模块含 Delete 类高危 skill:validate_cleanup_empty_folders / validate_fix_missing_scripts 一旦 dryRun=false 即真删;它们在 Approval / Auto 下被 IsForbiddenInSemi 自动拦截,仅 Bypass 或 Allowlist 命中可执行。强烈建议先用 dryRun=true 预览。

DO NOT (common hallucinations):

  • Validation skill routes use the validate_* prefix, not validation_*
  • validation_run / validation_check do not exist → use specific skills such as validate_scene, validate_project_structure, validate_missing_references
  • validation_fix does not exist → validation skills report issues; use other modules to fix them
  • validation_clean does not exist → use cleaner module for cleanup operations

Routing:

  • For unused/duplicate asset cleanup → use cleaner module
  • For missing script fix → cleaner_fix_missing_scripts (cleaner module)
  • For compile errors → debug_check_compilation (debug module)

Skills Overview

| Skill | Description | |-------|-------------| | validate_scene | Comprehensive scene validation | | validate_find_missing_scripts | Find objects with missing scripts | | validate_fix_missing_scripts | Remove missing script components | | validate_cleanup_empty_folders | Remove empty folders | | validate_find_unused_assets | Find potentially unused assets | | validate_texture_sizes | Check texture sizes | | validate_project_structure | Get project overview | | validate_missing_references | Find null/missing object references on components | | validate_mesh_collider_convex | Find non-convex MeshColliders | | validate_shader_errors | Find shaders with compilation errors |

Six more skills carry SkillCategory.Validation but are implemented and documented in the batch module, so GET /skills/recommend?category=validation returns them alongside the ten above. Their parameters live in ../batch/SKILL.md; each is a preview that you commit with batch_execute(confirmToken), except batch_validate_scene_objects, which is a plain read-only report.

| Skill | Description | |-------|-------------| | batch_validate_scene_objects | Analyze scene objects for missing scripts, missing references, duplicate names, and empty objects | | batch_fix_missing_scripts | Preview batch removal of missing scripts | | batch_cleanup_temp_objects | Preview deleting temporary helper objects by common temp-name patterns | | batch_standardize_naming | Preview standardizing names by trimming whitespace and normalizing separators | | batch_set_render_layer | Preview setting GameObject layers in batch | | batch_replace_material | Preview replacing materials in batch |


Skills

validate_scene

Comprehensive scene validation.

| Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | checkMissingScripts | bool | No | true | Check for missing scripts | | checkMissingPrefabs | bool | No | true | Check for missing prefabs | | checkDuplicateNames | bool | No | true | Check duplicate names | | checkEmptyGameObjects | bool | No | false | Check empty GameObjects (no components) |

Returns: {scene, totalIssues, summary: {errors, warnings, info}, issues: [{type, severity, gameObject, path, message, count}]}

validate_find_missing_scripts

Find objects with missing script references.

| Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | searchInPrefabs | bool | No | true | Also check prefab assets |

Returns: {totalFound, objects: [{source, gameObject, path, missingCount, prefabPath?}]} (prefabPath only present when source="Prefab")

validate_fix_missing_scripts

Remove missing script components.

| Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | dryRun | bool | No | true | Preview only, don't remove |

Returns: {success, dryRun, fixedCount, message, objects: [{gameObject, path, missingCount}]}

validate_cleanup_empty_folders

Remove empty folders from project.

| Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | rootPath | string | No | "Assets" | Starting folder | | dryRun | bool | No | true | Preview only, don't delete |

Returns: { success, dryRun, emptyFolderCount, folders, message }

validate_find_unused_assets

Find potentially unused assets.

| Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | assetType | string | No | "Material" | Filter: Texture/Material/Prefab/etc | | limit | int | No | 100 | Max results |

Returns: { success, assetType, potentiallyUnusedCount, assets }

validate_texture_sizes

Check for oversized textures.

| Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | maxRecommendedSize | int | No | 2048 | Warn if larger | | limit | int | No | 50 | Max results |

Returns: {maxRecommendedSize, largeTextureCount, textures: [{path, name, width, height, maxTextureSize, format, recommendation}]}

validate_project_structure

Get project folder structure overview.

| Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | rootPath | string | No | "Assets" | Starting folder | | maxDepth | int | No | 2 | Max folder depth |

Returns: { success, rootPath, assetCounts, structure }

validate_missing_references

Find null/missing object references on components in the scene.

| Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | limit | int | No | 50 | Max results |

Returns: { success, count, issues: [{ gameObject, path, component, property }] }

validate_mesh_collider_convex

Find non-convex MeshColliders (potential performance issue).

| Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | limit | int | No | 50 | Max results |

Returns: { success, count, nonConvexColliders: [{ gameObject, path, vertexCount }] }

validate_shader_errors

Find shaders with compilation errors.

| Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | limit | int | No | 50 | Max results |

Returns: { success, count, shaders: [{ name, path, errorCount }] }


Common Workflows

Pre-Build Check

import unity_skills

# Validate scene
scene_result = unity_skills.call_skill("validate_scene")
if scene_result['totalIssues'] > 0:
    print(f"Warning: {scene_result['totalIssues']} issues found")

# Check texture sizes
texture_result = unity_skills.call_skill("validate_texture_sizes", maxRecommendedSize=2048)
if texture_result['largeTextureCount'] > 0:
    print(f"Warning: {texture_result['largeTextureCount']} oversized textures")

Project Cleanup

import unity_skills

# 1. Preview missing scripts fix
preview = unity_skills.call_skill("validate_fix_missing_scripts", dryRun=True)
print(f"Would fix {preview['fixedCount']} objects")

# 2. Actually fix (if preview looks good)
unity_skills.call_skill("validate_fix_missing_scripts", dryRun=False)

# 3. Preview empty folder cleanup
preview = unity_skills.call_skill("validate_cleanup_empty_folders", dryRun=True)
print(f"Would delete {len(preview['folders'])} folders")

# 4. Actually cleanup
unity_skills.call_skill("validate_cleanup_empty_folders", dryRun=False)

# 5. Review unused assets (manual review recommended)
unused = unity_skills.call_skill("validate_find_unused_assets")
for asset in unused['assets']:
    print(f"Potentially unused: {asset}")

Best Practices

  1. Always use dryRun=True first to preview changes
  2. Run validation before major builds
  3. Review unused assets manually before deletion
  4. Keep texture sizes appropriate for target platform
  5. Fix missing scripts before they cause runtime errors
  6. Regular cleanup prevents project bloat

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

View on GitHub
GitHub Stars1.8k
CategoryDevelopment
Updated1mo ago
Forks165

Languages

C#

Trust signals

100/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

No cautions