unity-addressables-design

Codify Unity Addressables design rules across versions 1.22.3 and 2.9.1.

Updated Mar 30, 2026
One-click install
npx skills add https://github.com/krl76/MP-Study-Projects --skill unity-addressables-design
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: unity-addressables-design
Source: https://github.com/krl76/MP-Study-Projects/tree/main/Practice1/.codex/skills/unity-skills/skills/addressables-design
Command: npx skills add https://github.com/krl76/MP-Study-Projects --skill unity-addressables-design

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Unity Addressables evolve between 1.22.3 and 2.9.1; this Skill codifies design rules to prevent deprecated APIs, leaks, and incorrect lifecycle handling that hinder stable builds and live-ops.

Core Features & Use Cases

  • Establishes version-aware guidance for InitializeAsync, LoadAssetAsync, and LoadSceneAsync usage to avoid breaking changes.
  • Documents catalog update, bundle cache, and asset reference lifecycles to prevent leaks and mis-releases in complex projects.
  • Provides migration guidance for projects porting between Unity versions, including deprecations and new SceneReleaseMode behavior.

Quick Start

Review the two version contexts and follow the canonical patch-flow for catalog updates before implementing any Addressables calls.

Frequently Asked Questions about unity-addressables-design

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

FAQPage Schema
How do I migrate Unity Addressables from 1.22.3 to 2.9.1 without breaking deprecated APIs?▼

To migrate Unity Addressables from 1.22.3 to 2.9.1, apply codified design rules for deprecated APIs, new SceneReleaseMode behavior, and lifecycle handling to ensure stable builds and live-ops.

What causes memory leaks when using Unity Addressables LoadAssetAsync and LoadSceneAsync?▼

Memory leaks in Unity Addressables LoadAssetAsync and LoadSceneAsync occur due to incorrect lifecycle handling and mis-releases; codifying asset reference lifecycles and bundle cache rules prevents these leaks.

What is the correct patch-flow for Unity Addressables UpdateCatalogs during live-ops?▼

The correct patch-flow for Unity Addressables UpdateCatalogs involves reviewing version-specific contexts and applying canonical catalog update rules before implementing any Addressables calls to prevent runtime errors.

Does Unity Addressables 2.9.1 change the behavior of InitializeAsync and AssetReference usage?▼

Yes, Unity Addressables 2.9.1 introduces new SceneReleaseMode behavior and alters InitializeAsync and AssetReference usage, requiring version-aware design rules to avoid deprecated APIs and breaking changes.

When should I apply version-aware design rules for Unity Addressables architecture?▼

You should apply version-aware design rules for Unity Addressables architecture during porting, migration, and architecture decisions to prevent deprecated APIs, leaks, and incorrect lifecycle handling.