unity-validation
Validate project and scene health plus cleanup
How do I install this agent skill?
npx skills add https://github.com/besty0728/unity-skills --skill unity-validationIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill provides Unity project validation and cleanup tools. It is generally safe but carries a minor risk typical of tools that process external files and have file-system modification capabilities.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- Runlayerpass
1 file scanned · No issues
What does this agent skill do?
Unity Validation Skills
Find problems in the scene and project (missing scripts and references, unused assets, oversized textures, shader errors). Parameters come from the schema (GET /skills/schema?names=<skill>&wire=v2); execution and dryRun rules: root SKILL.md.
When to use
- Checking broken or missing references
- Validating scene or project integrity
- Cleaning up before a build
Rules
- Analysis skills are read-only.
validate_fix_missing_scriptsandvalidate_cleanup_empty_foldersdelete whendryRun=false; both default todryRun=true, so preview first. - Compile errors belong to
debug_check_compilationin the debug module. - Unused or duplicate asset cleanup belongs to the cleaner module.
- Batch fixes and previews that carry
SkillCategory.Validationare documented in batch (see the table below).
Pitfalls
- The prefix is
validate_*, notvalidation_*.validation_run,validation_check,validation_fixandvalidation_cleando not exist. - The validate skills report issues; they do not fix them. Use
cleaner_fix_missing_scriptsin the cleaner module to fix missing scripts.
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 the 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: {assetType, potentiallyUnusedCount, note, assets}. note warns that assets may still be used through scripts or Resources.Load.
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 a 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 or 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 (a 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}]}
Batch-owned validation skills
Six more skills carry SkillCategory.Validation but are documented in batch, so GET /skills/recommend?category=validation returns them with the ten above. Each is a preview that you commit with batch_execute(confirmToken), except batch_validate_scene_objects, a 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 |
Workflow
- Run
validate_sceneandvalidate_find_missing_scriptsto see what is broken. - Preview a fix:
POST /skill/validate_fix_missing_scripts?expectProject=<project>with{"dryRun":true}. - Run it with
{"dryRun":false}only after the preview looks right.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/besty0728/unity-skills/unity-validation">View unity-validation on skillZs</a>