# Unity Addressables

> Manage Unity Addressables groups and content with unity-cli. Use when the user asks to list or create a group, add or remove an entry, build or clean addressables content, or analyze and fix addressables issues before a build. Do not use for generic import settings or material edits; use `unity-asset-management` instead.

- Skill: `akiojin/unity-addressables` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add akiojin/unity-addressables`
- Raw SKILL.md: https://api.skillmd.com/api/skills/akiojin/unity-addressables/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: akiojin (https://skillmd.com/u/akiojin)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/akiojin/unity-addressables

---


# Addressables

Manage Addressable asset groups, build content, and analyse bundles. This skill is the content-delivery sibling of `unity-asset-management`.

## Use When

- The user wants to manage Addressables groups or entries.
- The task involves building or cleaning Addressables content.
- The user wants an analysis pass or automatic issue fix before shipping content.

## Do Not Use When

- The task is about general asset import settings or dependency analysis outside Addressables; use `unity-asset-management`.
- The request is about scene object setup rather than content delivery; use `unity-gameobject-edit` or `unity-scene-create`.

## Preferred Flow

1. Inspect existing groups before creating or moving entries.
2. Apply group or entry changes with `addressables_manage`.
3. Run `addressables_analyze` before a build, and use `fix_issues` only when the reported changes are acceptable.
4. Build with `addressables_build`, using `clean_build` when structure changed substantially.

```bash
unity-cli raw addressables_manage --json '{"action":"list_groups"}'
unity-cli raw addressables_manage --json '{"action":"create_group","groupName":"Characters"}'
unity-cli raw addressables_manage --json '{"action":"add_entry","groupName":"Characters","assetPath":"Assets/Prefabs/Hero.prefab","address":"hero"}'
unity-cli raw addressables_analyze --json '{"action":"analyze"}'
unity-cli raw addressables_build --json '{"action":"clean_build"}'
```

## Examples

- "Create an Addressables group for character prefabs and add the hero prefab."
- "Analyze Addressables issues and then build content."
- "Run a clean Addressables build after reorganising groups."

## References

- [runtime-checklist.md](references/runtime-checklist.md): connection and instance prerequisites.
- [addressables-build-loop.md](references/addressables-build-loop.md): safer order for group changes, analysis, and clean builds.