unity-validation

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

Updated Aug 31, 2026
One-click install
npx skills add https://github.com/pikachu0310/codex-agent-ops-public --skill unity-validation-pikachu0310
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unity-validation
Source: https://github.com/pikachu0310/codex-agent-ops-public/tree/main/.agents/skills/unity-skills/skills/validation
Command: npx skills add https://github.com/pikachu0310/codex-agent-ops-public --skill unity-validation-pikachu0310

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Unity projects accumulate broken references, missing scripts, empty folders, and oversized textures that cause build failures and runtime errors. This Skill detects and reports these issues, and can safely clean them up with dry-run previews before any destructive change. ## 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, which are blocked outside Bypass or allowlisted modes. - Asset Health Audits: Find potentially unused assets and oversized textures exceeding a configurable size threshold before builds. - Use Case: Before a release build, run validate_scene and validate_texture_sizes to catch issues, preview validate_fix_missing_scripts with dryRun, then apply the fix once the preview looks correct. ## Quick Start Ask the agent to validate the current Unity scene for missing scripts and broken references, previewing any cleanup with dry run enabled.

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 GameObjects with missing script references, optionally including prefab assets via the searchInPrefabs parameter. To remove them, preview with validate_fix_missing_scripts using dryRun=true before applying changes.

How to clean up empty folders in a Unity project?

Run validate_cleanup_empty_folders with a rootPath such as Assets and dryRun=true to preview which folders would be deleted. Set dryRun=false only after reviewing the preview, since deletion is a high-risk operation gated by approval mode.

Can this skill detect oversized textures before a Unity build?

Yes, validate_texture_sizes reports textures exceeding a configurable maxRecommendedSize, defaulting to 2048 pixels. It returns each texture's path, dimensions, format, and a recommendation for reducing size.

Why is validate_fix_missing_scripts blocked from running?

Delete-class skills are marked FullAuto and are intercepted by IsForbiddenInSemi in Approval or Auto modes. They only execute in Bypass mode or when allowlisted, so always preview with dryRun=true first.

What is the difference between the validation and cleaner modules?

Validation skills report project health issues like missing references and shader errors, while the cleaner module handles unused or duplicate asset cleanup. Compile errors should be checked with debug_check_compilation in the debug module.