How do I install the Uloop Compile skill?

Run npx skillmds@latest add haruma-k/uloop-compile in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Uloop Compile safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Uloop Compile?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Uloop Compile free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Uloop Compile?

haruma-k (@haruma-k) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Uloop Compile by haruma-k — Agent Skill

Name: Uloop Compile
Author: haruma-k

File contents

npx --yes uloop-cli@2.2.0 compile

Execute Unity project compilation.

Usage

npx --yes uloop-cli@2.2.0 compile [--force-recompile <true|false>] [--wait-for-domain-reload <true|false>]

Parameters

Parameter	Type	Default	Description
`--force-recompile`	boolean value	`false`	Force full recompilation (triggers Domain Reload). Rarely needed — see "When to use --force-recompile" below. Pass `true` or `false`; bare flags are not accepted.
`--wait-for-domain-reload`	boolean value	`false`	Wait until Domain Reload completes before returning. Pass `true` or `false`; bare flags are not accepted.

When to use --force-recompile

Almost never. Unity itself detects changed files — even when they were edited outside the Editor, a plain npx --yes uloop-cli@2.2.0 compile runs every recompilation the changes require. A forced full recompile can freeze the Editor for a long time on large projects, and with --wait-for-domain-reload true the response crosses a Domain Reload so Success comes back as null, making it useless as a verification step. The only legitimate use: surfacing warnings hidden by other asmdefs with a full build.

Global Options

Option	Description
`--project-path <path>`	Optional. Use only when the target Unity project is not the current directory.

Examples

# Check compilation
npx --yes uloop-cli@2.2.0 compile

# Force full recompilation
npx --yes uloop-cli@2.2.0 compile --force-recompile true

# Force recompilation and wait for Domain Reload completion
npx --yes uloop-cli@2.2.0 compile --force-recompile true --wait-for-domain-reload true

# Wait for Domain Reload completion even without force recompilation
npx --yes uloop-cli@2.2.0 compile --force-recompile false --wait-for-domain-reload true

Output

Returns JSON:

Success: boolean
ErrorCount: number
WarningCount: number

Troubleshooting

Diagnose the failure mode before retrying.

Stale lock files (CLI hangs or shows "Unity is busy" while Unity Editor is running):

npx --yes uloop-cli@2.2.0 fix

This removes any leftover lock files (compiling.lock, domainreload.lock, serverstarting.lock) from the Unity project's Temp directory. Then retry npx --yes uloop-cli@2.2.0 compile.

Unity Editor not running (CLI returns a connection failure and no Unity process is alive):

npx --yes uloop-cli@2.2.0 launch

npx --yes uloop-cli@2.2.0 launch auto-detects the project at the current working directory and opens it in the matching Unity Editor version. After Unity finishes launching, retry npx --yes uloop-cli@2.2.0 compile.

---name: uloop-compiledescription: Compile the Unity project and report errors/warnings. Use after C# edits or when a full Domain Reload compile is needed.---# npx --yes uloop-cli@2.2.0 compileExecute Unity project compilation.## Usage```bashnpx --yes uloop-cli@2.2.0 compile [--force-recompile <true|false>] [--wait-for-domain-reload <true|false>]```## Parameters| Parameter | Type | Default | Description ||-----------|------|---------|-------------|| `--force-recompile` | boolean value | `false` | Force full recompilation (triggers Domain Reload). Rarely needed — see "When to use --force-recompile" below. Pass `true` or `false`; bare flags are not accepted. || `--wait-for-domain-reload` | boolean value | `false` | Wait until Domain Reload completes before returning. Pass `true` or `false`; bare flags are not accepted. |## When to use --force-recompileAlmost never. Unity itself detects changed files — even when they were edited outside theEditor, a plain `npx --yes uloop-cli@2.2.0 compile` runs every recompilation the changes require. A forced fullrecompile can freeze the Editor for a long time on large projects, and with`--wait-for-domain-reload true` the response crosses a Domain Reload so `Success` comes backas `null`, making it useless as a verification step. The only legitimate use: surfacingwarnings hidden by other asmdefs with a full build.## Global Options| Option | Description ||--------|-------------|| `--project-path <path>` | Optional. Use only when the target Unity project is not the current directory. |## Examples```bash# Check compilationnpx --yes uloop-cli@2.2.0 compile# Force full recompilationnpx --yes uloop-cli@2.2.0 compile --force-recompile true# Force recompilation and wait for Domain Reload completionnpx --yes uloop-cli@2.2.0 compile --force-recompile true --wait-for-domain-reload true# Wait for Domain Reload completion even without force recompilationnpx --yes uloop-cli@2.2.0 compile --force-recompile false --wait-for-domain-reload true```## OutputReturns JSON:- `Success`: boolean- `ErrorCount`: number- `WarningCount`: number## TroubleshootingDiagnose the failure mode before retrying.**Stale lock files** (CLI hangs or shows "Unity is busy" while Unity Editor *is* running):```bashnpx --yes uloop-cli@2.2.0 fix```This removes any leftover lock files (`compiling.lock`, `domainreload.lock`, `serverstarting.lock`) from the Unity project's Temp directory. Then retry `npx --yes uloop-cli@2.2.0 compile`.**Unity Editor not running** (CLI returns a connection failure and no Unity process is alive):```bashnpx --yes uloop-cli@2.2.0 launch````npx --yes uloop-cli@2.2.0 launch` auto-detects the project at the current working directory and opens it in the matching Unity Editor version. After Unity finishes launching, retry `npx --yes uloop-cli@2.2.0 compile`.

Frequently asked questions

Uloop Compile