unity-validation

Validate Unity scenes and projects for missing scripts, broken references, and oversized textures.

Updated Aug 18, 2026
One-click install
npx skills add https://github.com/ethanJPope/Our-Main-Hackathon-Game --skill unity-validation-ethanjpope
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unity-validation
Source: https://github.com/ethanJPope/Our-Main-Hackathon-Game/tree/main/.agents/skills/unity-skills/skills/validation
Command: npx skills add https://github.com/ethanJPope/Our-Main-Hackathon-Game --skill unity-validation-ethanjpope

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Unity projects accumulate broken references, missing scripts, empty folders, and oversized textures that cause runtime errors and build failures. This Skill scans scenes and project assets to detect these issues and, where safe, cleans them up with preview-first dry-run controls. ## Core Features & Use Cases - Scene and Project Validation: Run comprehensive checks for missing scripts, missing prefabs, duplicate names, null component references, non-convex MeshColliders, and shader compilation errors. - Safe Cleanup with Dry Run: Preview removal of missing script components and empty folders with dryRun=true before committing destructive delete operations. - Asset Health Audits: Find potentially unused assets and flag textures exceeding recommended sizes for your target platform. - Use Case: Before a production build, run validate_scene and validate_texture_sizes to catch issues, preview validate_fix_missing_scripts, then apply fixes only after reviewing the dry-run report. ## Quick Start Ask the AI to validate the current Unity scene for missing scripts and broken references, then preview cleanup of empty folders using dry run mode.

Frequently Asked Questions about unity-validation

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find missing scripts in a Unity scene?

Use validate_find_missing_scripts to list all GameObjects with missing script references, optionally including prefab assets via the searchInPrefabs parameter. To remove them, run validate_fix_missing_scripts with dryRun=true first to preview the changes.

How to check a Unity project for issues before a build?

Run validate_scene for a comprehensive check covering missing scripts, missing prefabs, and duplicate names, then validate_texture_sizes to flag oversized textures. Review the issue counts and severity summary before proceeding with the build.

Can I preview deletions before removing empty folders in Unity?

Yes, validate_cleanup_empty_folders defaults to dryRun=true, returning the list of empty folders without deleting anything. Set dryRun=false only after reviewing the preview, since the delete operation is gated behind approval or bypass modes.

Does Unity validation detect null references on components?

Yes, validate_missing_references scans scene components for null or missing object references and reports the GameObject, path, component, and property for each issue. Results are capped by the limit parameter, defaulting to 50.

What are the limitations of unused asset detection in Unity?

validate_find_unused_assets only flags potentially unused assets filtered by type, such as Material or Texture, and cannot confirm true usage through dynamic or code-based references. Manual review is recommended before deleting anything it reports.