cuozg/unity-optimize
skills/unity-optimize/SKILL.md
Optimize Unity project performance — code hot paths, build settings, rendering, memory, physics, and platform-specific tuning. Auto-triages: Code (GC elimination, allocation-free patterns, Jobs/Burst migration in specific scripts), Settings (Player Settings, Quality Settings, Physics Settings, platform config for target hardware), Audit (full project performance sweep with ranked findings and applied fixes). MUST use for ANY Unity optimization request — "make this faster," "reduce GC," "optimize for mobile," "reduce build size," "too many draw calls," "memory issues," "frame drops during gameplay," "performance pass," "optimize my project," "why is my game slow," even when the user doesn't say "optimize" explicitly but describes performance symptoms. Do not use for profiler data analysis (unity-profiler), code refactoring without perf focus (unity-code), or general code writing (unity-code).
$ install --global
skillsauthnpx skillsauth add cuozg/oh-my-skills unity-optimizeInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 13, 2026, 2:48 AM131.6s10 files scanned
SKILL.md
- name:
- unity-optimize
- description:
- >
- physics, and platform-specific tuning. Auto-triages:
- Code (GC elimination, allocation-free
- author:
- kuozg
- version:
- 2.1
unity-optimize
Analyze performance bottlenecks, apply targeted fixes, verify improvement. Always measure before and after.
Step 1 — Detect Mode
| Signal | Mode | |--------|------| | Specific script(s), "optimize this Update," "reduce GC in this code" | Code | | Build size, Player/Quality Settings, platform config, "optimize for mobile" | Settings | | "Performance audit," "full sweep," general "why is my game slow" | Audit |
State triage: "This is [mode] — [reason]."
Step 2 — Execute
Code Mode
- Read target files fully before changing anything
- Scan
references/code-scan-patterns.md+unity-standards/review/performance-checklist.md:- GC in Update (LINQ, string concat, lambdas, boxing,
new) - Per-frame
GetComponent/Find/FindObjectOfType - Wrong collection type, linear search in hot path
- Missing
sealedon leaf MonoBehaviours
- GC in Update (LINQ, string concat, lambdas, boxing,
- Rank by frame-time impact: Critical → Warning → Info
- Fix using
references/gc-allocation-patterns.md+references/allocation-free-cookbook.md:- Cache in
Awake/Start· Replace LINQ with loops · UseNonAllocphysics · Pool objects
- Cache in
- Instrument
ProfilerMarkersviareferences/profiling-instrumentation.md - Verify
lsp_diagnosticson every changed file - Report each change, pattern fixed, estimated impact
Settings Mode
- Ask: target platform(s), fps target, current pain points, Unity version
- Load relevant guide from unity-standards
optimization/<topic>.md - Examine
ProjectSettings/if accessible; else ask user about current settings - Output ranked recommendations: setting name · current value · recommended value · expected impact
Settings mode provides recommendations only — user applies in Unity Editor.
Audit Mode
- Scope: target platform, fps target, known bottlenecks, project size
- Grep all runtime
.csfor hot-path anti-patterns (seereferences/code-scan-patterns.md) - Check
ProjectSettings/against platform best practices - Review assets via
references/asset-optimization.md - Rank findings (Critical/Warning/Info) by estimated impact
- Generate report via
references/audit-report-template.md - Offer to apply code fixes for top findings
Rules
- Measure before optimizing — establish baseline, don't guess
lsp_diagnosticsafter every code change- Never sacrifice correctness without explicit user approval
- Ask target platform before recommending platform-specific settings
- For structural cleanup without perf focus →
unity-code· For profiler analysis →unity-profiler
MCP Profiler Tools
| Purpose | Tool |
|---------|------|
| Baseline GC (all frames) | Unity.Profiler_GetOverallGcAlloca |
| Baseline frame time | Unity.Profiler_GetFrameRangeTopTimeSummary |
| Verify GC reduction | Unity.Profiler_GetFrameGcAllocati |
| Verify time improvement | Unity.Profiler_GetFrameTopTimeSam |
Full tool decision tree: read_skill_file("unity-standards", "references/other/unity-mcp-routing-matrix.md") → Profiling Branch.
Standards
Via read_skill_file("unity-standards", "references/<path>"):
review/checklist.md§4 ·quality/performance-audit.md·code-standards/performance-data.mdoptimization/build-settings.md·optimization/rendering-settings.md·optimization/memory-settings.mdoptimization/physics-settings.md·optimization/mobile-settings.md·optimization/jobs-burst-migration.md
Via read_skill_file("unity-optimize", "references/<path>"):
gc-allocation-patterns.md·allocation-free-cookbook.md·code-scan-patterns.mddraw-call-reduction.md·asset-optimization.md·platform-targets.mdprofiling-instrumentation.md·benchmark-template.md·audit-report-template.md
Related Skills
cuozg/unity-image-gen
tools
VerifiedTrustedCommunity
Generate Unity raster image assets through Unity MCP: game sprites, item art, backgrounds, UI icons, portraits, concept images, transparent cutouts, image edits, upscales, background removal, and Unity scene or Game View screenshots. Use when a Unity project needs image files imported under Assets or screenshots captured from the editor. Do not use for meshes, audio, animation, materials, gameplay code, UI Toolkit layout, or generic non-Unity image generation.
4SKILL.mdUpdated May 29, 2026
cuozg/unity-technical
tools
VerifiedTrustedCommunity
Create Unity technical solution documents from user requirements, feature ideas, bug goals, specs, or codebase problems. Use when the user asks for a technical approach, architecture, implementation strategy, solution options, feasibility analysis, system design, or "how should we build/fix this" for Unity runtime, Editor, tools, assets, data, UI, WebGL, SDKs, or production pipelines.
4SKILL.mdUpdated May 26, 2026
cuozg/unity-mcp-orchestrator
tools
VerifiedTrustedCommunity
Orchestrate Unity Editor via MCP (Model Context Protocol) tools and resources. Use when working with Unity projects through MCP for Unity - creating/modifying GameObjects, editing scripts, managing scenes, running tests, or any Unity Editor automation. Provides best practices, tool schemas, and workflow patterns for effective Unity-MCP integration.
4SKILL.mdUpdated May 21, 2026
cuozg/goal-todo
development
VerifiedTrustedCommunity
Convert a spec document into an implementation TODO list in the same spec folder. U se when the user says goal-todo, todo from spec, generate tasks from spec, turn this spec into todos, create implementation checklist, extract tasks, or asks to read a Docs/Specs design doc and produce what must be implemented. Includes UI/UX review and codebase investigation before writing the checklist. Do not use for implementing the tasks, creating new goal files, writing test cases, or verifying completed work.
4SKILL.mdUpdated May 21, 2026