unity-asmdef

Advises on Unity assembly definition layout, dependency direction, and editor/runtime/test splits.

Updated Oct 13, 2025
One-click install
npx skills add https://github.com/Darth-Carrotpie/ProxyCore --skill unity-asmdef-darth-carrotpie
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: unity-asmdef
Source: https://github.com/Darth-Carrotpie/ProxyCore/tree/main/.agents/skills/unity-skills/skills/asmdef
Command: npx skills add https://github.com/Darth-Carrotpie/ProxyCore --skill unity-asmdef-darth-carrotpie

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Large Unity projects suffer from slow compile times and tangled code dependencies when everything lives in one default assembly. This Skill helps you decide whether assembly definitions (asmdef) are justified and how to structure them without creating fragmentation or circular dependencies. ## Core Features & Use Cases - Justification Assessment: Evaluates whether your project size, domain count, and compile times actually warrant introducing asmdef files. - Architecture Proposal: Outputs proposed assemblies, allowed dependency direction, and an editor/runtime/test split plan. - Migration Guidance: Provides step-by-step migration steps plus risks and churn to avoid, such as circular dependencies or dumping-ground assemblies. - Use Case: Your Unity project's compile times have grown painful and editor scripts are mixed with runtime code. Ask for an asmdef plan and receive a directional dependency graph with a clean editor/runtime/test separation. ## Quick Start Ask the agent to review my Unity project structure and propose an asmdef layout that separates editor, runtime, and test code to speed up compilation.

Frequently Asked Questions about unity-asmdef

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

FAQPage Schema
How do I split Unity code into asmdef assemblies?▼

Start by separating editor code from runtime code, then group runtime code into a few meaningful domain assemblies. Keep the dependency graph directional and shallow, and add a dedicated test assembly that references only what it tests.

When should I use asmdef files in Unity?▼

Use asmdef when the project has multiple domains or systems, editor and runtime code are mixed, compile times are noticeable, or tests need clean isolation. For tiny prototypes, asmdef fragmentation adds overhead without benefit.

Do asmdef files speed up Unity compilation?▼

Yes, asmdef files let Unity recompile only the assemblies affected by a change instead of the entire project. The benefit grows with project size, but only if dependencies are kept directional and shallow.

Why does my asmdef setup cause circular dependency errors?▼

Circular dependencies occur when two assemblies reference each other directly or through a chain. Fix this by extracting shared types into a lower-level assembly both sides depend on, and avoid routing everything through one shared dumping-ground assembly.

What are the risks of using too many asmdef files?▼

Over-fragmentation creates maintenance churn, complicated reference management, and harder refactoring across boundaries. Prefer a few meaningful assemblies aligned with real domains over many tiny ones.