zsutxz/Unity Script Validator

Unity Script Validator

Validates Unity C# scripts against best practices and performance patterns specific to Unity game development.

What This Skill Checks

• Field declarations: [SerializeField] private instead of public fields
• Component caching: GetComponent in Awake/Start, not Update (~100x faster)
• String operations: StringBuilder for frequent concatenation
• GameObject.Find: Cache references, avoid in Update (O(n) operation)
• Code organization: #region directives, consistent ordering
• XML documentation: <summary> tags on public methods
• Update vs FixedUpdate: Appropriate usage for physics/non-physics
• Coroutines: Prefer for intermittent tasks over Update

Provides: Issues found, specific fixes, performance impact estimates, refactored code examples.

Compatibility

Applies to Unity 2019.4 LTS and later (including Unity 6).

See patterns.md and examples.md for detailed optimization techniques.

When to Use vs Other Components

Use this Skill when: Quick validation of existing Unity scripts for best practices and common issues

Use @unity-scripter agent when: Writing new code or implementing Unity features from scratch

Use @unity-refactor agent when: Improving code quality, applying design patterns, or modernizing legacy code

Use @unity-performance agent when: Deep performance profiling, memory optimization, or platform-specific tuning

Use /unity:new-script command when: Creating new scripts from production-ready templates

Related Skills

• unity-scene-optimizer: For scene-level performance analysis
• unity-template-generator: For generating validated script templates