unity-addressables-design

Implement Addressables 1.22.3 and 2.9.1 APIs with correct handle release and catalog sequencing.

6|Updated Apr 2, 2026
One-click install
npx skills add https://github.com/dyCuong03/unity-agent-team --skill unity-addressables-design-dycuong03
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unity-addressables-design
Source: https://github.com/dyCuong03/unity-agent-team/tree/main/.claude/skills/unity-skills/skills/addressables-design
Command: npx skills add https://github.com/dyCuong03/unity-agent-team --skill unity-addressables-design-dycuong03

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents common Unity Addressables integration failures by enforcing version-aware, source-anchored design rules before you write or modify Addressables initialization, loading, scene handling, catalog updates, downloads, and AssetReference usage.

Core Features & Use Cases

  • Version-safe API usage: Avoids calling non-Async or removed APIs that fail compilation or break behavior between Addressables 1.22.3 and 2.9.1.
  • Correct handle lifetime management: Ensures every AsyncOperationHandle is released to prevent AssetBundle memory leaks.
  • Reliable catalog update sequencing: Enforces CheckForCatalogUpdates → UpdateCatalogs ordering and safe CleanBundleCache timing.
  • Scene release correctness: Guides correct use of SceneReleaseMode (2.9.1) and activateOnLoad patterns to avoid bundle lifetime bugs.
  • AssetReference correctness: Differentiates AssetReference cached-handle release from direct Addressables handle release to prevent double-release exceptions.

Quick Start

Load the unity-addressables-design module before you implement any Addressables.InitializeAsync, LoadAssetAsync/LoadAssetsAsync, InstantiateAsync, LoadSceneAsync/UnloadSceneAsync, UpdateCatalogs, download/preload, or AssetReference code so your implementation matches the required version-specific contracts and release semantics.

Frequently Asked Questions about unity-addressables-design

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

FAQPage Schema
How do I prevent Unity Addressables memory leaks when using AsyncOperationHandle?

To prevent Unity Addressables memory leaks, you must enforce correct AsyncOperationHandle lifetime management by ensuring every handle is explicitly released. This Skill guides you in applying the required release discipline to avoid AssetBundle memory leaks across Unity versions.

What is the correct sequence for Unity Addressables catalog updates and CleanBundleCache?

The correct Unity Addressables catalog update sequence requires strict CheckForCatalogUpdates followed by UpdateCatalogs ordering, with safe CleanBundleCache timing applied afterward. This Skill enforces that specific sequencing to prevent catalog update and bundle cache failures.

How do I handle Unity Addressables scene release correctly with SceneReleaseMode?

To handle Unity Addressables scene release correctly, you must use SceneReleaseMode in version 2.9.1 and proper activateOnLoad patterns. This Skill guides correct usage to avoid bundle lifetime bugs during LoadSceneAsync and UnloadSceneAsync operations.

Why does my Unity Addressables AssetReference throw a double-release exception?

A Unity Addressables AssetReference throws a double-release exception when cached-handle release is not differentiated from direct Addressables handle release. This Skill provides rules to differentiate AssetReference release mechanics and prevent double-release exceptions.

Does this approach support Unity Addressables version differences between 1.22.3 and 2.9.1?

Yes, this approach supports Unity Addressables version differences by enforcing version-safe API usage for both 1.22.3 and 2.9.1. It prevents calling non-Async or removed APIs that fail compilation or break behavior between these specific Addressables versions.

What are the limitations when implementing WebGL-safe async patterns for Unity Addressables?

Limitations when implementing WebGL-safe async patterns for Unity Addressables include avoiding blocking calls and adhering strictly to async-only APIs. This Skill constrains you to WebGL-safe async patterns to ensure downloading and preloading work correctly on the web platform.