Agent skill
Unity Scene Optimizer
Analyzes scenes for performance bottlenecks (draw calls, batching, textures, GameObjects). Use when optimizing scenes or investigating performance issues.
Install this agent skill to your Project
npx add-skill https://github.com/Dev-GOM/claude-code-marketplace/tree/main/plugins/unity-dev-toolkit/skills/unity-scene-optimizer
SKILL.md
Unity Scene Optimizer
Analyzes Unity scenes and provides performance optimization recommendations for rendering, physics, memory, and platform-specific concerns.
What This Skill Analyzes
1. Rendering Performance
Analyzes draw calls (target: <100 mobile, <2000 desktop), identifies batching opportunities, recommends material consolidation and static batching.
2. Texture Optimization
Reviews compression formats (BC7/ASTC), mipmap usage, texture atlasing, and platform-specific import settings.
3. GameObject Hierarchy
Targets: <500 GameObjects mobile, <2000 desktop. Identifies deep nesting, recommends object pooling and LOD groups.
4. Lighting and Shadows
Recommends baked lighting over realtime (1-2 lights mobile, 3-4 desktop), minimal shadow-casting lights.
5. Physics Optimization
Analyzes Rigidbody count, collider complexity, collision matrix configuration. Recommends simple colliders over Mesh colliders.
6. Mobile-Specific
Platform targets: 60 FPS iOS (iPhone 12+), 30-60 FPS Android. See mobile-checklist.md for complete requirements.
Optimization Workflow
- Measure: Frame Debugger, Stats, Profiler metrics
- Identify: GPU/CPU/Memory/Physics bottlenecks
- Apply: Quick wins (static batching, compression) → Medium (atlases, pooling, LOD) → Major (hierarchy refactor, culling)
- Validate: Compare before/after metrics
See optimization-workflow.md for detailed steps and timelines.
Platform-Specific Targets
| Platform | Draw Calls | Triangles | Texture Memory | Lights |
|---|---|---|---|---|
| Mobile Low | <50 | <20k | <100MB | 1 |
| Mobile Mid | <100 | <50k | <250MB | 1-2 |
| Mobile High | <150 | <100k | <500MB | 2-3 |
| PC Low | <500 | <200k | <1GB | 3-4 |
| PC Mid | <1000 | <500k | <2GB | 4-6 |
| PC High | <2000 | <1M | <4GB | 6-8 |
| Console | <1000 | <800k | <3GB | 4-6 |
Tools Reference
Frame Debugger, Profiler, Stats Window, Memory Profiler. See tools-reference.md for usage and commands.
Output Format
Provides: Current metrics, bottleneck identification, prioritized recommendations, performance impact estimates, implementation steps.
When to Use vs Other Components
Use this Skill when: Analyzing scene performance, identifying bottlenecks, or getting optimization recommendations
Use @unity-performance agent when: Implementing complex optimizations, profiling at runtime, or troubleshooting specific performance issues
Use @unity-architect agent when: Redesigning scene architecture, implementing object pooling systems, or planning large-scale optimizations
Use /unity:optimize-scene command when: Running comprehensive scene analysis with detailed reports
Related Skills
- unity-script-validator: For script-level performance issues
- unity-template-generator: For optimized component templates
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
unity-editor-toolkit
Unity Editor control and automation, WebSocket-based real-time communication. 유니티에디터제어및자동화, WebSocket기반실시간통신. Features/기능: GameObject control 게임오브젝트제어, Transform manipulation 트랜스폼조작, Component management 컴포넌트관리, Scene management 씬관리, SQLite database integration SQLite데이터베이스통합, GUID-based persistence GUID기반영구식별, Multi-scene synchronization 멀티씬동기화, Command Pattern with Undo/Redo 명령패턴실행취소재실행, Menu execution 메뉴실행, ScriptableObject management 스크립터블오브젝트관리, Array/List manipulation 배열리스트조작, All field types support 모든필드타입지원, Material/Rendering 머티리얼/렌더링, Prefab system 프리팹시스템, Asset Database 애셋데이터베이스, Animation 애니메이션, Physics 물리, Console logging 콘솔로깅, EditorPrefs management 에디터프리퍼런스관리, Editor automation 에디터자동화, Build pipeline 빌드파이프라인, Lighting 라이팅, Camera 카메라, Audio 오디오, Navigation 네비게이션, Particles 파티클, Timeline 타임라인, UI Toolkit, Profiler 프로파일러, Test Runner 테스트러너. Protocol 프로토콜: JSON-RPC 2.0 over WebSocket (port 9500-9600). 500+ commands 명령어, 25 categories 카테고리. Real-time bidirectional communication 실시간양방향통신. Security 보안: Defense-in-depth 심층방어 (path traversal protection 경로순회방지, command injection defense 명령어인젝션방어, JSON injection prevention JSON인젝션방지, SQL injection prevention SQL인젝션방지, transaction safety 트랜잭션안전성). Localhost-only connections 로컬호스트전용. Cross-platform 크로스플랫폼 (Windows, macOS, Linux).
blender-toolkit
Blender automation with geometry creation, materials, modifiers, and Mixamo animation retargeting. Core Features: WebSocket-based real-time control, automatic bone mapping with UI review, two-phase confirmation workflow, quality assessment, multi-project support, comprehensive CLI commands. Use Cases: Create 3D primitives (cube, sphere, cylinder, etc.), manipulate objects (transform, duplicate, delete), manage materials and modifiers, retarget Mixamo animations to custom rigs with fuzzy bone matching.
unity-test-runner
Execute and analyze Unity Test Framework tests from the command line. This skill automates test execution for Unity projects by detecting the Unity Editor, configuring test parameters (EditMode/PlayMode), running tests via CLI, parsing XML results, and generating detailed failure reports. Use this when running Unity tests, validating game logic, or debugging test failures.
Unity Template Generator
Generates production-ready C# script templates (MonoBehaviour, ScriptableObject, Editor, tests). Use when creating new scripts or setting up project structure.
unity-compile-fixer
Detect and resolve Unity C# compilation errors using VSCode diagnostics. Use this skill when Unity projects have compilation errors that need diagnosis and automated fixes. Analyzes errors from VSCode Language Server, proposes solutions based on error patterns, and handles version control conflicts for Unity projects.
Unity UI Toolkit
Assists with Unity UI Toolkit development - UXML structure, USS styling, C# VisualElement manipulation, data binding, and custom controls. Use when implementing UI Toolkit interfaces.
Didn't find tool you were looking for?