Unity Game Architecture

Unity game architecture decision patterns. Service Locator vs Singleton vs DI, Event Bus vs ScriptableObject channels, MonoBehaviour vs plain C#, component composition, manager bootstrap sequences. DECISION format: WHEN/DECISION/SCAFFOLD/GOTCHA. Based on Unity 6.3 LTS.

40 stars 6 forksSoftware Development

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add Nice-Wolf-Studio/unity-claude-skills --skill unity-game-architecture
Manual install
git clone --depth 1 https://github.com/Nice-Wolf-Studio/unity-claude-skills.git /tmp/unity-claude-skills
mkdir -p ~/.claude/skills
cp -r /tmp/unity-claude-skills/skills/unity-game-architecture ~/.claude/skills/unity-game-architecture

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Game Systems Architecture -- Decision Patterns

> **Prerequisite skills:** `unity-scripting` (MonoBehaviour, ScriptableObjects, events), `unity-lifecycle` (RuntimeInitializeOnLoadMethod, DontDestroyOnLoad, SubsystemRegistration), `unity-foundations` (components, GameObjects)

These patterns address the most common architectural failure: Claude defaults to fat MonoBehaviours with direct references and singletons everywhere. This works for prototypes but collapses at system scale.

---

## PATTERN: Global Service Access

WHEN: Systems need to find other systems at runtime (AudioManager, InputManager, SaveManager, etc.)

DECISION:
- **Lazy Singleton** -- Tiny project, 1-3 managers, no testing needed. `static Instance` + `DontDestroyOnLoad`. Fast to write, impossible to mock.
- **Service Locator** -- Medium project, want to swap implementations for testing (mock audio, stub save). Central registry with `Register<T>/Get<T>`. Dependencies are implicit but swappable.
- **Constructor/Method DI** -- Large project or library code, maximum testability. Pass dependencies explicitly. Use VContainer or Zenject for MonoBehaviour injection.

SCAFFOLD (Service Locator):
Read the full skill on GitHub

Details

Skill name
unity-game-architecture
Path
skills/unity-game-architecture/SKILL.md
License
MIT
Repo updated
15 September 2026

FAQ

What does the Unity Game Architecture skill do?

Unity game architecture decision patterns. Service Locator vs Singleton vs DI, Event Bus vs ScriptableObject channels, MonoBehaviour vs plain C#, component composition, manager bootstrap sequences. DECISION format: WHEN/DECISION/SCAFFOLD/GOTCHA. Based on Unity 6.3 LTS.

How do I install the Unity Game Architecture skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add Nice-Wolf-Studio/unity-claude-skills --skill unity-game-architecture. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Unity Game Architecture popular?

It lives in Nice-Wolf-Studio/unity-claude-skills, which has 40 GitHub stars and 6 forks.

Related skills

Unity 2d

40

Nice-Wolf-Studio/unity-claude-skills

Unity 6 2D game development guide. Use when building 2D games, working with sprites, sprite atlas, SpriteRenderer, tilemaps, 2D physics (Rigidbody2D, Collider2D), 2D lighting, sorting layers, or sorting groups. Based on Unity 6.3 LTS documentation.

Research & Science

Unity 3d Math

40

Nice-Wolf-Studio/unity-claude-skills

Unity 3D math correctness patterns. Catches common mistakes with coordinate spaces, Quaternion, Vector3, Plane, Bounds, Transform hierarchies, raycasting projection, and floating-point precision. PATTERN format: WHEN/WRONG/RIGHT/GOTCHA. Based on Unity 6.3 LTS documentation.

Images, Video & Audio

Unity AI Navigation

40

Nice-Wolf-Studio/unity-claude-skills

Unity 6 AI and navigation guide. Use when working with NavMesh, pathfinding, NavMeshAgent, NavMeshSurface, NavMeshObstacle, off-mesh links, or Unity Sentis (ML model inference). Covers AI navigation package, runtime NavMesh baking, and common AI patterns like state machines and behavior trees. Based on Unity 6.3 LTS documentation.

AI, LLMs & Agents

Unity Game Loop

40

Nice-Wolf-Studio/unity-claude-skills

Unity game loop and progression design-to-code translation. Core loop scaffolding, session lifecycle, win/lose condition architecture, meta loop hooks, tunable difficulty, pacing & encounter timing. DESIGN INTENT format: INTENT/WRONG/RIGHT/SCAFFOLD/DESIGN HOOK. Based on Unity 6.3 LTS.

Software Development

Unity CLI Contract

40

Nice-Wolf-Studio/unity-claude-skills

Use when a unity command fails with exit 2 or "unknown option"; when a subcommand's help prints the root help instead of its own; when the CLI hangs on a pager or a first-run prompt; when a flag documented in the skill does not exist on the installed binary; before parsing or scripting any unity output; when the unity-cli skill is not installed.

Software Development

Unity Npc Behavior

40

Nice-Wolf-Studio/unity-claude-skills

Unity NPC behavior design-to-code translation. Perception system architecture, decision layer patterns, action execution pipeline, faction & relationship systems, NPC memory & forgetting, crowd & squad coordination. DESIGN INTENT format: INTENT/WRONG/RIGHT/SCAFFOLD/DESIGN HOOK. Based on Unity 6.3 LTS.

Software Development

Browse the most popular Claude skills, all software development skills, or write your own with the skills generator.