skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
besty0728/unity-skills88 installs

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-validation
view source ↗

Is 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_scripts and validate_cleanup_empty_folders delete when dryRun=false; both default to dryRun=true, so preview first.
  • Compile errors belong to debug_check_compilation in the debug module.
  • Unused or duplicate asset cleanup belongs to the cleaner module.
  • Batch fixes and previews that carry SkillCategory.Validation are documented in batch (see the table below).

Pitfalls

  • The prefix is validate_*, not validation_*. validation_run, validation_check, validation_fix and validation_clean do not exist.
  • The validate skills report issues; they do not fix them. Use cleaner_fix_missing_scripts in the cleaner module to fix missing scripts.

Skills

validate_scene

Comprehensive scene validation.

ParameterTypeRequiredDefaultDescription
checkMissingScriptsboolNotrueCheck for missing scripts
checkMissingPrefabsboolNotrueCheck for missing prefabs
checkDuplicateNamesboolNotrueCheck duplicate names
checkEmptyGameObjectsboolNofalseCheck 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.

ParameterTypeRequiredDefaultDescription
searchInPrefabsboolNotrueAlso 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.

ParameterTypeRequiredDefaultDescription
dryRunboolNotruePreview only, don't remove

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

validate_cleanup_empty_folders

Remove empty folders from the project.

ParameterTypeRequiredDefaultDescription
rootPathstringNo"Assets"Starting folder
dryRunboolNotruePreview only, don't delete

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

validate_find_unused_assets

Find potentially unused assets.

ParameterTypeRequiredDefaultDescription
assetTypestringNo"Material"Filter: Texture, Material, Prefab, etc.
limitintNo100Max 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.

ParameterTypeRequiredDefaultDescription
maxRecommendedSizeintNo2048Warn if larger
limitintNo50Max results

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

validate_project_structure

Get a project folder structure overview.

ParameterTypeRequiredDefaultDescription
rootPathstringNo"Assets"Starting folder
maxDepthintNo2Max folder depth

Returns: {success, rootPath, assetCounts, structure}

validate_missing_references

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

ParameterTypeRequiredDefaultDescription
limitintNo50Max results

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

validate_mesh_collider_convex

Find non-convex MeshColliders (a performance issue).

ParameterTypeRequiredDefaultDescription
limitintNo50Max results

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

validate_shader_errors

Find shaders with compilation errors.

ParameterTypeRequiredDefaultDescription
limitintNo50Max 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.

SkillDescription
batch_validate_scene_objectsAnalyze scene objects for missing scripts, missing references, duplicate names and empty objects
batch_fix_missing_scriptsPreview batch removal of missing scripts
batch_cleanup_temp_objectsPreview deleting temporary helper objects by common temp-name patterns
batch_standardize_namingPreview standardizing names by trimming whitespace and normalizing separators
batch_set_render_layerPreview setting GameObject layers in batch
batch_replace_materialPreview replacing materials in batch

Workflow

  1. Run validate_scene and validate_find_missing_scripts to see what is broken.
  2. Preview a fix: POST /skill/validate_fix_missing_scripts?expectProject=<project> with {"dryRun":true}.
  3. Run it with {"dryRun":false} only after the preview looks right.

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>