Skip to content

Unity ECS Patterns

Guides the agent through Unity DOTS (ECS, Jobs, Burst) patterns for high-performance game code

Repository
wshobson/agents
Stars
42,095
Licence
MIT
Files
2 files

What it does

When installed, the agent gets a reference guide on Unity's Data-Oriented Technology Stack, which is a way of organizing game code so that large numbers of objects (entities) are processed efficiently in batches rather than one by one. It explains core ideas such as entities, components, systems, archetypes and chunks, compares this approach with traditional object-oriented code, and lists best practices like preferring ISystem over SystemBase, batching structural changes with an entity command buffer, avoiding managed types in Burst-compiled code, and disposing native collections. The skill only shapes the agent's advice and code suggestions; it does not run anything by itself.

Great for

  • Unity developers moving performance-critical game logic to DOTS
  • Teams simulating thousands of units, projectiles or particles and hitting CPU limits
  • Developers converting existing object-oriented gameplay code to ECS

Skip it if

  • Beginners building a simple Unity game, since the skill assumes familiarity with Unity and C# and advises against over-architecting (the reason: ECS adds complexity that small projects do not need)
  • Non-Unity engines such as Godot or Unreal, since the content is specific to Unity DOTS
  • Anyone expecting verified, project-specific answers; the guidance is general and the files show no tested code samples or version details

Try asking

  • “Convert my MonoBehaviour enemy spawner into an ISystem that handles 10,000 entities”
  • “Review my job system code and tell me where I am making structural changes inside jobs”
  • “Explain archetypes and chunks so I can decide how to group my bullet components”
  • “Show me how to use an EntityCommandBuffer to spawn and destroy entities safely”
Step-by-step guide: how to use Unity ECS PatternsInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 2 original files, the MIT licence and an attribution note.

    unity-ecs-patterns.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip unity-ecs-patterns.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip unity-ecs-patterns.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Give the agent your Unity version and the DOTS package versions you use, since APIs change between releases
  • Paste the actual code you want reviewed rather than asking for general advice, so the agent can apply the checklist to it
  • Verify generated code in the Unity Profiler and Burst inspector before relying on it, because the skill itself contains no worked code

What's inside

  • references/details.md
  • SKILL.md

Redistributed unmodified from wshobson/agents under the MIT licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.