Skip to content

Firzus/agent-skills / skills/game/unity/unity-core

unity-core

Unverified

Use for any Unity task: writing, reviewing, or architecting Unity code, choosing between two Unity tools that do the same job, or when the user mentions Unity, CoreCLR, IL2CPP, Awaitable, Addressables, Content Directories, DOTS, ECS, Jobs, Burst, assembly definitions, Input System, audio, project structure, CI, builds, tests, or performance. Load it alongside the domain skills unity-ui, unity-editor-tools, unity-rendering, unity-multiplayer, unity-cli, and unity-play.

Unity Core

Ship on the default stack below. Each row names the one tool to reach for, so the choice is already made — spend the thinking on the feature instead.

This skill describes the latest Unity version the team uses, and nothing older. The Editor and desktop players run on CoreCLR; Android, iOS, and the Web build with IL2CPP. Code targets C# 9 and .NET Standard 2.1 until Unity ships .NET 10 and C# 14; runtime.md owns what the runtime changes for your code.

For what a build actually ships, read its release notes and Unity's Discussions posts: the manual still carries pages written for earlier versions.

The default stack

NeedReach forInstead of
Any new UIUI Toolkit — unity-uiUGUI
World-space / diegetic UIPanel RendererUGUI world canvas, render texture
TextAdvanced Text Generatorhand-rolled layout
Player-facing text in several languagesLocalization module + Smart Strings, see unity-uithe Localization package, hand-rolled string tables
Authoring UI for a custom toolUI Toolkit — unity-editor-toolsOdin, IMGUI, a node canvas
Heterogeneous items in one authored list[SerializeReference] + AdvancedDropdownone list per type
Tool iconsBuilt-in Editor icons, then painter2Dshipping PNG variants per state
AsyncAwaitable + CancellationTokencoroutines, raw Task
Static state across Play Mode entries[AutoStaticsCleanup], see runtime.mdexpecting a reload to reset it
Runtime loadingAddressables + AssetReference, every group on the Content Directory schema; post-install content goes through a project system until Unity ships remote Content Directories, see assets.md; settings needed before the first scene go through the Preloaded AssetsResources/, Loadable<T> without Addressables
InputInput System action mapslegacy Input Manager
Audiobuilt-in AudioMixer — workflow.mdFMOD/Wwise
Render pipelineURP — unity-renderingBuilt-In, HDRP
Custom render passesRender GraphScriptableRenderPass.Execute
Lighting, static scenesAdaptive Probe Volumes + baked lightmapsLight Probe Groups
Light bakingUnity Compute Light Baker, set as the Default Light Bakerevery other light-baking backend
Lighting, dynamic scenesSurface Cache GIbaking a scene that moves
Draw-call reduction and occlusionGPU Resident Drawer + GPU occlusion cullingstatic batching
PoolingUnityEngine.Poolhand-rolled pools
Object identityEntityId (64-bit)GetInstanceID(), int ids
Hot pathsJobs + Bursta full ECS rewrite
NetcodeNetcode for GameObjects — unity-multiplayerNetcode for Entities
Authorityclient-serverdistributed authority
Sessions, matchmaking, relayMultiplayer ServicesLobby + Matchmaker + Relay separately
Server buildsDedicated Server + Multiplayer Rolesa hand-stripped client build
Testing multiple peersMultiplayer Play Modeseveral Editor installs
Per-platform build configBuild Profileshand-edited global Build Settings
Build-time scene processingAssetPostprocessor.OnProcessSceneIProcessSceneWithReport, [PostProcessScene]
TestsUnity Test Framework, edit-mode firstplay-mode by default
Tests while the Editor is openunity command run_tests — unity-cliclosing the Editor for unity test
Release buildsCoreCLR on desktop; IL2CPP on Android, iOS, and the WebIL2CPP on desktop
Driving the Editor from an agentUnity CLI — unity-cliasking the user to click through the Editor

Leave a default only where the linked reference gives that row an escape hatch. Say which row you left and what made it worth leaving.

Reference

TopicFile
CoreCLR runtime, static state, serialization, EntityIdruntime.md
Composition, asmdefs, Awaitable, Jobs/Burst/ECS, profiling, allocationsarchitecture.md
Exceptions, nullability, async void, the UnityEngine.Object null trapcode-standards.md
Folder layout, naming, GUID-safe renamesproject-structure.md
Addressables, Content Directories, import settings, scenes, prefabsassets.md
Input, audio, version control, CI, builds, testingworkflow.md
Device measurement, character animation, particles, managed code stripping, Android LTO, iOS memory limitsperformance.md

Domain skills

Each domain has its own skill, which applies this default stack and review pass. When the task touches a domain, load its skill; when that skill is not installed, say which one is missing and work from the rows above.

DomainSkill
UI Toolkit, USS versus CSS, design tokens, data binding, MVP, localizationunity-ui
Figma designs as UI Toolkit interfacesfigma-to-unity
Custom Editor tools, inspectors, [SerializeReference]unity-editor-tools
Pipeline, lighting, GPU-driven renderingunity-rendering
Netcode, authority, sessions, dedicated serverunity-multiplayer
Unity CLI, driving the Editor from an agent, iterating while the user tests in the Editorunity-cli
An agent playing the game in Play Mode, reproducing a gameplay bug by playingunity-play
Performance review of a diff or folder: rule scan of code, Editor audit of assets and settingsunity-performance

For engine-agnostic replication theory, use coop-session.

Review pass

Read changed code against every row of the default stack, then account for each line below — name the file and line where it holds, or fix it:

Several rows are conditional: they bind only when the change performs the operation they describe. "Not applicable, this change does not do that" is a complete answer, and the right one. Test the condition, never the presence of a token — and never infer the rule from how many neighbouring files show the same pattern, since copy-paste propagates a mistake as reliably as a convention.

- [ ] Statics reset through `[AutoStaticsCleanup]` or a lifecycle hook, so entering Play Mode twice behaves identically
- [ ] Every Awaitable carries a CancellationToken scoped to its component
- [ ] Every CancellationTokenSource this change creates, linked ones included, is disposed by its owner
- [ ] Assets load through Addressables, and every handle is released or bound to a lifetime token
- [ ] Update() free of allocation, GetComponent, Find*, and LINQ
- [ ] Runtime spawns come from a pool
- [ ] No runtime ParticleSystem.Simulate fast-forwards a Noise system by seconds
- [ ] Object identity flows through EntityId
- [ ] Player-facing strings come from Localization tables
- [ ] [SerializeField] on fields only ([field: SerializeField] for properties)
- [ ] Logic sits in plain C# in its own asmdef, covered by edit-mode tests
- [ ] Renamed assets moved with their .meta, via git mv
- [ ] Networked state gated on HasAuthority
- [ ] Editor code under an Editor asmdef, runtime types in runtime assemblies
- [ ] Any rename or move of a [SerializeReference] type in this change lands with [MovedFrom] naming its real former address (no former address, no attribute)
- [ ] Custom inspectors built on UI Toolkit, with IMGUIContainer only where named

When the user asks for something off the default stack, name the row, state what it costs, and follow their call.

finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 319kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 319kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 319kUpdated Claude CodeCodexVerifiedInstall
skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.Stars: 196kUpdated Claude CodeCodexVerifiedInstall