unity-addressables-design

Provide version-aware design rules for Unity Addressables migrations across 1.22.3 and 2.9.1.

1|Updated May 21, 2026
One-click install
npx skills add https://github.com/YiDuandtdt/Bone-Throne --skill unity-addressables-design-yiduandtdt
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unity-addressables-design
Source: https://github.com/YiDuandtdt/Bone-Throne/tree/main/.agents/skills/unity-skills/skills/addressables-design
Command: npx skills add https://github.com/YiDuandtdt/Bone-Throne --skill unity-addressables-design-yiduandtdt

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Unity projects face brittle migrations when Addressables APIs change between 1.22.3 and 2.9.1; this Skill provides version-aware design rules to prevent broken builds and misuses.

Core Features & Use Cases

  • Version-diff aware migration guidance for InitializeAsync, LoadAssetAsync, LoadSceneAsync, UpdateCatalogs, and related APIs.
  • Safe sequencing guidelines for catalog checks, updates, and bundle cache management across Unity versions.
  • Real-world scenarios and concrete patterns to avoid leaks, double releases, and scene unload pitfalls.

Quick Start

Review the migration rules before touching InitializeAsync or LoadAssetAsync to ensure safe, future-proof Addressables usage.

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 version 1.22.3 to 2.9.1 safely?

Safe Unity Addressables migration requires version-aware design rules to prevent broken builds across 1.22.3 and 2.9.1. Apply concrete patterns and safe sequencing guidelines for InitializeAsync, LoadAssetAsync, and catalog updates to ensure future-proof code.

What is the best way to sequence Unity Addressables catalog updates and bundle cache management?

Sequencing Addressables catalog updates and bundle cache management requires strict ordering across versions. Follow safe sequencing guidelines for catalog checks, updates, and bundle cache management to avoid misuses and ensure proper async operation flow.

Why does my Unity Addressables LoadSceneAsync or LoadAssetAsync implementation fail after a version update?

Addressables LoadSceneAsync and LoadAssetAsync implementations fail after version updates due to API changes between 1.22.3 and 2.9.1. Use version-diff aware migration guidance to select the correct overloads and avoid scene unload pitfalls.

How do I prevent asset leaks and double releases when managing Unity Addressables?

Preventing asset leaks and double releases in Unity Addressables requires applying concrete real-world patterns and actionable rules. Use version-aware design rules to sequence operations correctly and verify helper API usage across 1.22.3 and 2.9.1.

Do I need specific InitializeAsync overloads when upgrading Unity Addressables versions?

Upgrading Unity Addressables versions requires specific InitializeAsync overloads to prevent brittle migrations. The specification provides version-diff aware guidance on which overloads to use for safe initialization and future-proof code.

Are there limitations when using Unity Addressables helper APIs across different versions?

Yes, Unity Addressables helper APIs have limitations and behavioral differences across versions 1.22.3 and 2.9.1. The specification provides verification anchors and concrete guidance on which helper API overloads to use to avoid broken builds.