# manage-sprite-atlas

This skill guides SpriteAtlas creation and setup in Unity projects through the build pipeline. Use it when configuring built-in atlases or Addressables loading.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 3400 installs · ★ 1149
- Author: Unity-Technologies
- License: LicenseRef-Unknown · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Unity-Technologies/skills/tree/HEAD/skills/manage-sprite-atlas/SKILL.md
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/skills/manage-sprite-atlas

## What it does

The skill guides SpriteAtlas work in Unity: it asks you to choose a delivery method, check for scripts already in the project, and configure Sprite Packer. Its default path generates atlases during the prebuild pipeline; manual authoring is reserved for cases where the user explicitly requests it.

Before code is written, the skill requires checking packing settings and reading relevant files from `resources/`. It keeps editor authoring separate from runtime atlas access. When `EditorSettings.spritePackerMode` is `Disabled`, the atlas will not pack, even if it appears ready in the editor.

On-demand loading through Addressables requires the Addressables package, a content build step, and a runtime loader script. This route also uses asynchronous loading and depends on a network connection. The skill asks you to choose between atlases included in the build for immediate access and Addressables loading on demand.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add Unity-Technologies/skills --skill manage-sprite-atlas -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/manage-sprite-atlas/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/manage-sprite-atlas/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add Unity-Technologies/skills --skill manage-sprite-atlas -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/manage-sprite-atlas/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add Unity-Technologies/skills --skill manage-sprite-atlas -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/manage-sprite-atlas/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Unity-Technologies/skills manage-sprite-atlas
```

2. **Manually: put the files in place**
- File: `.github/skills/manage-sprite-atlas/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add Unity-Technologies/skills --skill manage-sprite-atlas -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/Unity-Technologies/skills --path skills/manage-sprite-atlas
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/manage-sprite-atlas/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add Unity-Technologies/skills --skill manage-sprite-atlas -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/Unity-Technologies/skills/tree/HEAD/skills/manage-sprite-atlas/SKILL.md

## When to use it
- generate SpriteAtlas assets during a Unity build
- set up on-demand atlas loading with Addressables
- check whether Sprite Packer is enabled
- decide how existing atlas scripts should be handled

## Example prompts
- Set up Unity sprite atlases for the main UI and generate them during the build.
- Prepare Addressables loading for atlases used by downloadable content.
- Check for existing SpriteAtlas scripts and verify the packing mode before generating code.

## Similar
- [orbit-card](https://affpapa.org/en/nevibecode/skills/orbit-card.md) — skill · 10000 installs
- [cad](https://affpapa.org/en/nevibecode/skills/cad.md) — skill · 14000 installs
- [step-parts](https://affpapa.org/en/nevibecode/skills/step-parts.md) — skill · 11200 installs
- [sdf](https://affpapa.org/en/nevibecode/skills/sdf.md) — skill · 10500 installs
- [urdf](https://affpapa.org/en/nevibecode/skills/urdf.md) — skill · 10500 installs
- [hatch-pet](https://affpapa.org/en/nevibecode/skills/hatch-pet.md) — skill · 3300 installs

From the same set: [unity-technologies/skills](https://affpapa.org/en/nevibecode/by/unity-technologies/skills.md) — 31 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md