Unity ECS Patterns

SkillAI & models

unity-ecs-patterns is a skill that guides your agent in building high-performance Unity games using ECS, DOTS, Jobs, and Burst. It helps when you are building data-oriented games, optimizing performance, or working with large entity counts. The skill gives your agent concrete patterns for entity component system code so you can focus on game logic instead of low-level details.

Use Unity ECS Patterns in Claude, ChatGPT or Ahel Desktop

Free. Sign in, add Unity ECS Patterns and connect your AI. About a minute.

Also: Claude Code · Cursor · Codex

Then ask your AI: use the Unity ECS Patterns skill

Details

Instructions available. Your AI can read the instructions. Execution depends on the setup they require.

Have a Unity project that uses the Entity Component System packages.

Unity ECS PatternsStart free

What your AI can do with it

  • Apply ECS patterns to structure entities and components
  • Use DOTS to organize data-oriented game code
  • Write Jobs for parallel processing of entity data
  • Add Burst compilation for performance-critical code
  • Handle large entity counts with ECS architecture

Getting started

  1. Have a Unity project that uses the Entity Component System packages.
  2. Add the unity-ecs-patterns skill to your agent configuration.
  3. Ask your agent to apply ECS patterns when writing or reviewing game code.
  4. Provide the agent with your entity and component definitions for context.

What this skill tells your AI

The instructions your AI receives, as published by wshobson/agents in plugins/game-development/skills/unity-ecs-patterns/SKILL.md and read by ahel’s review.

Production patterns for Unity's Data-Oriented Technology Stack (DOTS) including Entity Component System, Job System, and Burst Compiler.

When to Use This Skill

  • Building high-performance Unity games
  • Managing thousands of entities efficiently
  • Implementing data-oriented game systems
  • Optimizing CPU-bound game logic
  • Converting OOP game code to ECS
  • Using Jobs and Burst for parallelization

Core Concepts

1. ECS vs OOP

AspectTraditional OOPECS/DOTS
Data layoutObject-orientedData-oriented
MemoryScatteredContiguous
ProcessingPer-objectBatched
ScalingPoor with countLinear scaling
Best forComplex behaviorsMass simulation

2. DOTS Components

Entity: Lightweight ID (no data)
Component: Pure data (no behavior)
System: Logic that processes components
World: Container for entities
Archetype: Unique combination of components
Chunk: Memory block for same-archetype entities

Detailed patterns and worked examples

Detailed pattern documentation lives in references/details.md. Read that file when the navigation tier above is insufficient.

Best Practices

Do's

  • Use ISystem over SystemBase - Better performance
  • Burst compile everything - Massive speedup
  • Batch structural changes - Use ECB
  • Profile with Profiler - Identify bottlenecks
  • Use Aspects - Clean component grouping

Don'ts

  • Don't use managed types - Breaks Burst
  • Don't structural change in jobs - Use ECB
  • Don't over-architect - Start simple
  • Don't ignore chunk utilization - Group similar entities
  • Don't forget disposal - Native collections leak

Signals

GitHub stars
40k
Forks
4k
Last commit
Sep 2026

Questions

What is unity-ecs-patterns?
It is a skill that guides your agent in building high-performance Unity games using ECS, DOTS, Jobs, and Burst. It helps with data-oriented game development, performance optimization, and large entity counts.
When should I use this skill?
Use it when building data-oriented games, optimizing performance, or working with large entity counts in Unity. It provides patterns for ECS, DOTS, Jobs, and Burst.
Does it support other game engines?
No. The skill is specific to Unity and its ECS, DOTS, Jobs, and Burst technologies.
Can it help with existing Unity projects?
Yes. The skill can guide your agent in applying ECS patterns to new or existing Unity projects that use the Entity Component System.
Advanced
Item type
skill
Key
unity-ecs-patterns
Source
github.com/wshobson/agents