unity-asmdef

Propose Unity asmdef groupings, dependency directions, and migration steps.

Updated Aug 23, 2026

Search Tags:#unity #compile-time #dependency-graph #asmdef #assembly-definition #editor-runtime #module-boundary

Ready to run

npx skills add https://github.com/mandexonla/Top-Down-Template --skill unity-asmdef-mandexonla

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: unity-asmdef
Source: https://github.com/mandexonla/Top-Down-Template/tree/main/.codex/skills/unity-skills/skills/asmdef
Command: npx skills add https://github.com/mandexonla/Top-Down-Template --skill unity-asmdef-mandexonla

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams reduce Unity compile times, enforce module boundaries, and cleanly separate editor, runtime, and test code so that dependency direction is explicit and incremental builds are faster.

Core Features & Use Cases

Propose meaningful asmdef groupings to avoid over-fragmentation while improving compile isolation.
Define allowed dependency directions and detect potential circular references in the dependency graph.
Recommend an editor/runtime/test split and provide practical migration steps with phased rollouts and risk mitigation.
Use Case: For a medium-sized Unity project with mixed editor and runtime code causing slow iteration, get a proposed assembly layout, dependency rules, and a migration plan to shorten edit-compile-test cycles.

Quick Start

Propose asmdef groupings, allowed dependency directions, and a migration plan for my Unity project that separates editor and runtime code and reduces incremental compile time.

Frequently Asked Questions about unity-asmdef

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I reduce Unity compile times using assembly definitions?▼

To reduce Unity compile times, assembly definitions (asmdef) split a project into isolated modules so Unity only recompiles changed code. This Skill proposes meaningful groupings and explicit dependency directions to speed up incremental builds.

What is the best way to separate editor and runtime code in Unity to prevent circular dependencies?▼

Separating editor and runtime code requires defining explicit asmdef boundaries to prevent circular dependencies. This Skill detects potential circular references in the dependency graph and recommends an editor/runtime/test split.

When do I need assembly definitions in my Unity project?▼

You need assembly definitions in medium-to-large Unity projects experiencing noticeable incremental compilation delays, or when you must cleanly isolate tests and editor-only assemblies from runtime code to enforce maintainable module boundaries.

How do I migrate an existing Unity project to use assembly definitions without breaking scripts?▼

Migrating to assembly definitions involves phased rollouts to avoid breaking scripts. This Skill provides practical migration steps and risk mitigations, proposing asmdef groupings that avoid over-fragmentation while improving compile isolation.

Can I use assembly definitions to isolate test assemblies in Unity?▼

Yes, assembly definitions can isolate test assemblies in Unity. This Skill recommends a clean editor/runtime/test split with explicit allowed dependency directions, ensuring test code remains decoupled from runtime modules.