Agent skill

Uloop Compile

by hatayama in hatayama/unity-cli-loop

Compile the Unity project and report errors/warnings. An agent skill from hatayama/unity-cli-loop.

MITAuto-check passedGame Development

Install Uloop Compile

skills CLI
$ npx skills add hatayama/unity-cli-loop --skill uloop-compile -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install hatayama/unity-cli-loop uloop-compile --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/hatayama/unity-cli-loop.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/uloop-compile .claude/skills/uloop-compile && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
uloop-compile
GitHub stars
576
Token cost
~1.3k tokens
SKILL.md length
699 words
Files
1
Skills in repo
11
Repo updated
First seen
Licence
MIT

At a glance

Compile the Unity project and report errors/warnings. An agent skill from hatayama/unity-cli-loop.

  • Game Development work in your project
  • SKILL.md covers When to use, Usage, Parameters and When to use --force-recompile, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Uloop Compile is an agent skill from hatayama/unity-cli-loop. Compile the Unity project and report errors/warnings. Use after C edits; to try edits in the running Editor without a domain reload, use hot-reload.

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Game Development. It works with C#. The repository describes itself as: Let AI Drive Unity, from Editor to Play Mode. The licence is MIT.

When your agent uses it

  • Game Development work in your project

Example prompts

  • “/uloop-compile”

What it can do on your machine

Read from SKILL.md and the folder at commit b05bd95. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Uloop Compile loads about 1.3k tokens when it runs. Until then it costs about 41 tokens; SKILL.md has 699 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~41
When it runs · the whole SKILL.md, loaded when a task matches
~1.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from hatayama/unity-cli-loop at commit b05bd95, republished under its MIT licence (© hatayama). 699 words, ~1,288 tokens.

Download SKILL.mdSave it as .claude/skills/uloop-compile/SKILL.md (or your agent's skills folder).
name
uloop-compile
description
Compile the Unity project and report errors/warnings. Use after C# edits; to try edits in the running Editor without a domain reload, use hot-reload.
toolName
compile

uloop compile

Execute Unity project compilation.

When to use

  • After C# edits, to check for compile errors and make the change live in the Editor (Play Mode, tests, a tool call): to land edits you finished trying with hot reload, or to apply structural changes hot reload cannot.
  • To try an edit in the running Editor, especially during Play Mode, run uloop hot-reload instead: a compile drops every hot-reload patch and discards the Play session.

Usage

bash
uloop compile [--force-recompile] [--no-wait-for-domain-reload] [--stop-on-external-scene-changes] [--timeout-seconds <seconds>]

Parameters

ParameterTypeDefaultDescription
--force-recompileflag-Full recompile plus domain reload. Almost never needed: a plain compile already detects externally edited files, and the forced reload can freeze large projects and come back as COMPILE_RESULT_UNKNOWN.
--no-wait-for-domain-reloadflag-Return before Domain Reload completion
--stop-on-external-scene-changesflag-Stop before compilation if open Scene files changed externally instead of auto-reloading them
--timeout-secondsinteger600Maximum seconds the CLI waits for the compile to finish before returning COMPILE_WAIT_TIMEOUT (default 600). Values above 1200 exceed the Unity-side result retention window (20 minutes) and weaken post-timeout recovery.

When to use --force-recompile

--force-recompile is almost never needed. Detecting changed files is Unity's job: even when files were edited outside the Editor, a plain uloop compile refreshes assets and runs every recompilation the changes require. "The files were changed externally, so recompile everything just in case" is not a valid reason.

Why to avoid it:

  • On large projects a full recompile plus domain reload can freeze Unity for a long time.
  • The result crosses a domain reload, so it often comes back as COMPILE_RESULT_UNKNOWN and does not work as a verification step.
  • It puts the Editor into the unstable just-after-reload state for no benefit.

The one legitimate use case: you need warnings hidden by other asmdefs surfaced by a full build. Otherwise always run plain uloop compile.

Output

Returns JSON:

  • Success: boolean or null
  • ErrorCount: number or null
  • WarningCount: number or null
  • Warning (string, optional): set when the compile was requested during Play Mode (the Play session is discarded), while pause points were armed in either Play Mode or Edit Mode (the domain reload drops every pause point patch; those enabled with --persist are counted separately and re-armed from their saved enable request after the reload), or while hot-reload changes were active (a successful compile drops every patch; the edited sources are compiled in).
  • Message: string
  • ErrorCode: string or null. COMPILE_ALREADY_IN_PROGRESS / COMPILE_EDITOR_UPDATING when Unity was still compiling or updating after the CLI waited for it and sent the compile again (it does so twice before giving up; run uloop compile again), COMPILE_RESULT_UNKNOWN after a forced recompile that did not return a definitive result.
  • NextActions: string array or null. Corrective steps derived from the errors, e.g. the assembly that declares an unresolved namespace (CS0234), or, for CS0246 in a script under an asmdef, a reminder to check that asmdef's references (the type may instead be a typo — decide from the error).
Show full SKILL.md (221 more words)Show less

When Unity stops compiling before the finish callback (Success: null, indeterminate), Message keeps the get-logs pointer and appends Recent Console errors: with the last few Console errors (typically the asmdef or compiler error that aborted the compile), so fix from that list before reaching for uloop get-logs.

Troubleshooting

When Unity's API Updater asks for consent to rewrite source files during a CLI compile (the 'Script Updating Consent' dialog), uloop declines automatically — source files are never rewritten without explicit user consent — and the response's Warning discloses the decline. The obsolete-API errors the updater would have fixed appear in Errors; fix them in code, or have the user accept the dialog in an interactive Unity session. Outside CLI compiles, and for the separate 'API Update Required' dialog, the modal can still appear and uloop cannot click it: if compile times out while the Editor looks idle, ask the user to answer the dialog — never auto-dismiss it.

A compile that outlives your shell's output window keeps running inside Unity: the call may return with empty or truncated output while the compile is still in progress, and the next uloop command is rejected with "Unity is busy running 'compile'" until it finishes. That rejection is normal single-flight behavior, not a failure — wait and rerun the command; do not restart Unity or rerun compile to recover.

© hatayama, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/uloop-compile of hatayama/unity-cli-loop.

Open the folder on GitHubat commit b05bd95

Compare with similar skills

Uloop Compile next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Uloop Compile compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Uloop Compile this skillhatayama/unity-cli-loop576—~1.3kAutomated safety check: PassMIT
Uloop Execute Dynamic CodeCyberAgentGameEntertainment/NovaShader1.6k1 repos~1.9kAutomated safety check: PassMIT
Locus Unity BridgeMisaka-Mikoto-Tech/agent-skills275—~4kAutomated safety check: PassMIT
Validate GsdkPlayFab/gsdk170—~645Automated safety check: PassApache-2.0
Aibridge Development WorkflowFlameskyDexive/Legends-Of-Heroes929—~790Automated safety check: PassMIT
Unity PluginTomLeeLive/openclaw-unity-plugin107—~5.1kAutomated safety check: PassApache-2.0

Similar skills

  • Uloop Execute Dynamic Code

    CyberAgentGameEntertainment/NovaShader

    Execute C with Unity APIs when existing uloop tools cannot inspect or edit enough.

    1.6k GitHub starsUsed in 1 repo~1.9k tokens
    Game DevelopmentAuto-check passed
  • Locus Unity Bridge

    Misaka-Mikoto-Tech/agent-skills

    A skill your agent uses when an agent needs to inspect or control a real Unity Editor through Locus, especially when Unity MCP is unavailable, named-pipe discovery is needed, C must be executed, or…

    275 GitHub stars~4k tokensUpdated 17 days ago
    Game DevelopmentAuto-check passed
  • Validate Gsdk

    PlayFab/gsdk

    Validates PlayFab Game Server SDK (GSDK) integrations in game server projects.

    170 GitHub stars~645 tokensUpdated 4 days ago
    Game DevelopmentAuto-check passed
  • Aibridge Development Workflow

    FlameskyDexive/Legends-Of-Heroes

    AIBridge/Unity 项目的标准开发工作流。Use when creating, modifying, fixing, refactoring, or validating C code, Unity assets, prefabs, editor tools, package structure, tests, AGENTS.md, or local Skills.

    929 GitHub stars~790 tokensUpdated 17 days ago
    Game DevelopmentAuto-check passed
  • Unity Plugin

    TomLeeLive/openclaw-unity-plugin

    Control Unity Editor via OpenClaw Unity Plugin. An agent skill from TomLeeLive/openclaw-unity-plugin.

    107 GitHub stars~5.1k tokensUpdated 1 mo ago
    Game DevelopmentAuto-check passed
  • Godot 2D Essentials

    jame581/GodotPrompter

    Covers Godot 4.3+ 2D systems with GDScript and C# examples: canvas layers, draw order, TileMaps, parallax, lights and shadows, particles and custom drawing.

    795 GitHub stars~2.3k tokensUpdated 2 days ago
    Game DevelopmentAuto-check passed

More from hatayama/unity-cli-loop

All 11 skills in this repo
  • Uloop Pause Point

    hatayama/unity-cli-loop

    Breakpoint-like: pause Unity at a source file:line without editing code or recompiling, and get the locals, parameters, and fields there.

    576 GitHub stars~2k tokensUpdated yesterday
    Auto-check passed
  • Uloop Record Video

    hatayama/unity-cli-loop

    Record the Game View or any Editor window (Scene, Inspector, ...) to an .mp4 or .webm video.

    576 GitHub stars~1.7k tokensUpdated yesterday
    Auto-check passed
  • Uloop Hot Reload

    hatayama/unity-cli-loop

    Apply C edits to the running Editor without a compile or domain reload, keeping Play Mode state.

    576 GitHub stars~2k tokensUpdated yesterday
    Auto-check passed
  • V3 CLI Invocation Migration

    hatayama/unity-cli-loop

    Migrate only uloop V2 CLI option syntax in agent skills, Markdown, POSIX shell scripts, and PowerShell scripts to V3 syntax.

    576 GitHub stars~1.2k tokensUpdated yesterday
    Auto-check passed
  • Uloop Get Project Info

    hatayama/unity-cli-loop

    Get Unity project information via uloop CLI. An agent skill from hatayama/unity-cli-loop.

    576 GitHub stars~228 tokensUpdated yesterday
    Auto-check passed
  • Uloop Hello World

    hatayama/unity-cli-loop

    Sample uloop hello-world tool. An agent skill from hatayama/unity-cli-loop.

    576 GitHub stars~321 tokensUpdated yesterday
    Auto-check passed

Works with

Questions about Uloop Compile

What does Uloop Compile do?

Compile the Unity project and report errors/warnings. An agent skill from hatayama/unity-cli-loop. Uloop Compile is an agent skill from hatayama/unity-cli-loop. Compile the Unity project and report errors/warnings.

When should I use Uloop Compile?

Uloop Compile fits situations like: game Development work in your project.

How do I install Uloop Compile in Claude Code?

Run `npx skills add hatayama/unity-cli-loop --skill uloop-compile -a claude-code`. Or copy the skill folder (.agents/skills/uloop-compile in hatayama/unity-cli-loop) into .claude/skills/uloop-compile in your project. Claude Code loads it when a task matches its description.

How do I install Uloop Compile in Codex?

Run `npx skills add hatayama/unity-cli-loop --skill uloop-compile -a codex`. Or copy the skill folder (.agents/skills/uloop-compile in hatayama/unity-cli-loop) into .agents/skills/uloop-compile in your project. Codex loads it when a task matches its description.

Can I use Uloop Compile in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add hatayama/unity-cli-loop --skill uloop-compile -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/uloop-compile, .gemini/skills/uloop-compile, .github/skills/uloop-compile and .opencode/skills/uloop-compile in your project.

What does Uloop Compile need to run?

SKILL.md names no scripts, command-line tools or credentials: Uloop Compile is instructions for the agent only.

Does Uloop Compile access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Uloop Compile safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Uloop Compile use?

Uloop Compile is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Uloop Compile use?

About 1.3k tokens (SKILL.md is roughly 5.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Uloop Compile?

Skills that share tags, products or a category with Uloop Compile: Uloop Execute Dynamic Code (CyberAgentGameEntertainment/NovaShader, 1.6k stars), Locus Unity Bridge (Misaka-Mikoto-Tech/agent-skills, 275 stars), Validate Gsdk (PlayFab/gsdk, 170 stars) and Aibridge Development Workflow (FlameskyDexive/Legends-Of-Heroes, 929 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Uloop Compile?

hatayama (a GitHub user) maintains it in hatayama/unity-cli-loop, which has 576 GitHub stars. The repository holds 11 skills in this directory. The repository was last updated on October 8, 2026.

Source: hatayama/unity-cli-loop on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.