assembly-definitions

Create and manage Unity .asmdef files to isolate code into independent assemblies.

3|Updated Apr 8, 2026
One-click install
npx skills add https://github.com/XeldarAlz/KlondikeSolitaire --skill assembly-definitions
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: assembly-definitions
Source: https://github.com/XeldarAlz/KlondikeSolitaire/tree/main/.claude/skills/core/assembly-definitions
Command: npx skills add https://github.com/XeldarAlz/KlondikeSolitaire --skill assembly-definitions

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Assembly definitions (.asmdef) split your project into separate compilation units. Without them, Unity recompiles ALL scripts on every change. With them, only the changed assembly and its dependents recompile.

Core Features & Use Cases

  • Improves iteration time by narrowing compilation scope
  • Organizes code into logical modules (Core, Gameplay, Systems, Tests)
  • Supports Editor vs Runtime separation and platform targeting
  • Encourages clean dependency structure and faster builds

Quick Start

Create a module-level .asmdef for each Unity project area and wire dependencies accordingly to ensure isolated compilation.

Frequently Asked Questions about assembly-definitions

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

FAQPage Schema
How do I reduce Unity compile times using assembly definitions?

Unity assembly definitions split your project into independent compilation units so only the changed assembly and its dependents recompile. This narrows the compilation scope and significantly improves iteration time during development.

What is the best way to structure Unity assemblies for Editor and Runtime separation?

Structuring Unity assemblies for Editor and Runtime separation involves creating module-level .asmdef files for each project area. This isolates Editor-specific scripts from Runtime code to ensure clean dependency direction and faster builds.

How do I prevent circular references when setting up Unity assembly definitions?

Preventing circular references in Unity assembly definitions requires wiring dependencies in a strict unidirectional flow. Organize modules into Core, Systems, and Tests to enforce clean dependency structure and avoid compilation errors.

When do I need to use .asmdef files in my Unity project?

You need .asmdef files in large Unity projects experiencing slow iteration due to recompiling all scripts on every change. They are essential for organizing multiple modules, platform-specific configurations, and test assemblies.

Does this approach support platform-specific configurations in Unity?

Yes, Unity assembly definitions support platform-specific configurations. By isolating code into independent assemblies, you can target specific platforms and restrict unnecessary compilation for unsupported environments.

How do I set up test assemblies in Unity without creating circular dependencies?

Set up Unity test assemblies by creating dedicated .asmdef files for Tests that reference your Core or Systems assemblies. This ensures test code remains isolated and prevents circular dependencies with runtime modules.