Agent skill

Uloop Status

by hatayama in hatayama/unity-cli-loop

Check whether the Unity Editor for this project can take a uloop command now, without side effects.

MITAuto-check passedGame Development

Install Uloop Status

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

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

GitHub CLI
$ gh skill install hatayama/unity-cli-loop uloop-status --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-status .claude/skills/uloop-status && 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-status
GitHub stars
577
Token cost
~826 tokens
SKILL.md length
439 words
Files
1
Skills in repo
11
Repo updated
First seen
Licence
MIT

At a glance

Check whether the Unity Editor for this project can take a uloop command now, without side effects.

  • Game Development work in your project
  • SKILL.md covers Usage, States, Output and Notes
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Uloop Status is an agent skill from hatayama/unity-cli-loop. Check whether the Unity Editor for this project can take a uloop command now, without side effects. Use before sending commands when Unity may be starting, compiling, busy, or closed.

Its SKILL.md is about 830 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 Unity. 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-status”

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 Status loads about 826 tokens when it runs. Until then it costs about 49 tokens; SKILL.md has 439 words of instructions outside code blocks.

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

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). 439 words, ~826 tokens.

Download SKILL.mdSave it as .claude/skills/uloop-status/SKILL.md (or your agent's skills folder).
name
uloop-status
description
Check whether the Unity Editor for this project can take a uloop command now, without side effects. Use before sending commands when Unity may be starting, compiling, busy, or closed.

uloop status

Report whether the Unity Editor for this project can take a uloop command now, without changing anything.

Usage

bash
uloop status
uloop status --project-path <path>

States

The states are checked in this order, and the first one that matches is reported.

StateMeaningExit code
BusyUnity answered, and a uloop command is running and holds the command slot1
StartingUnity answered but has not recorded its play and compile state yet1
MainThreadBlockedUnity answered, but its main thread has not run for 5 seconds or more, even when asked again after being woken1
CompilingUnity answered and is compiling scripts1
ImportingAssetsUnity answered and is importing assets1
ReadyUnity answered and none of the above applies0
NotRespondingConnected to Unity, but it did not answer within 5 seconds1
ServerUnavailableThe uloop server refused or dropped the connection, and Unity is running for this project1
NotRunningThe uloop server refused or dropped the connection, and no Unity Editor is running for this project1
UnreachableThe uloop server refused or dropped the connection, and the Unity process list could not be read1

Some failures are errors, not states: the operating system refusing the connection (as a sandbox does), an error answered by Unity (such as a package too old to support uloop status), an unreadable answer, or an unknown option. These print an error to stderr, nothing to stdout, and exit 1.

Show full SKILL.md (203 more words)Show less

Output

Returns JSON with:

  • State: one of the states above
  • Ready: true only for Ready
  • Message: what the state means for this Editor
  • NextActions: what to do next; an empty array for Ready
  • RunningToolName, RunningToolElapsedSeconds, RunningToolPhase (Executing or WaitingForMainThread): the running command; Busy only
  • IsPlaying, IsPaused, IsCompiling, IsUpdating: Unity's play and compile state; only when Unity answered and has recorded that state
  • SecondsSinceLastMainThreadTick: seconds since Unity's main thread last ran; only when Unity answered
  • UnityProcessRunning: whether Unity is running for this project; ServerUnavailable and NotRunning only
  • ConnectionError: the connection error as reported; NotResponding, ServerUnavailable, NotRunning, and Unreachable only

Play Mode does not change the state: a paused Play Mode session is Ready, with IsPlaying and IsPaused set.

Notes

  • Exits 0 only for Ready.
  • It never focuses the window, launches Unity, or takes the command slot, so it is safe to poll.
  • A sandboxed shell that cannot open the Unix socket gets an error, not NotRunning; run it outside the sandbox.
  • uloop cannot detect Safe Mode directly; ServerUnavailable that does not clear is the signal.
  • Before reporting MainThreadBlocked it wakes the Editor's main loop and asks again about a second later, so an Editor that is only idle in the background reads as Ready.

© 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-status of hatayama/unity-cli-loop.

Open the folder on GitHubat commit b05bd95

Compare with similar skills

Uloop Status 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 Status compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Uloop Status this skillhatayama/unity-cli-loop577—~826Automated safety check: PassMIT
Fantasy Framework Development Guideqq362946/Fantasy1.4k—~5.8kAutomated safety check: PassCustom licence
Locus Unity BridgeMisaka-Mikoto-Tech/agent-skills278—~4kAutomated safety check: PassMIT
AibridgeFlameskyDexive/Legends-Of-Heroes929—~2.1kAutomated safety check: PassMIT
Unity SkillsBesty0728/Unity-Skills1.8k—~2kAutomated safety check: PassMIT
Uloop Control Play ModeCyberAgentGameEntertainment/NovaShader1.6k1 repos~1.3kAutomated safety check: PassMIT

Similar skills

  • Development and review guide for the Fantasy C# distributed game server framework: ECS, FTask, routing, service discovery, config and databases.

    1.4k GitHub stars~5.8k tokensUpdated today
    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…

    278 GitHub stars~4k tokensUpdated 18 days ago
    Game DevelopmentAuto-check passed
  • Aibridge

    FlameskyDexive/Legends-Of-Heroes

    Unity Editor and Player Runtime CLI integration for AIBridge.

    929 GitHub stars~2.1k tokensUpdated 17 days ago
    Game DevelopmentAuto-check passed
  • Unity Skills

    Besty0728/Unity-Skills

    Automate the Unity Editor through a local REST API — scripts, scenes, prefabs, assets, materials, lighting, tests and hundreds of other Editor operations.

    1.8k GitHub stars~2k tokensUpdated yesterday
    Game DevelopmentAuto-check passed
  • Uloop Control Play Mode

    CyberAgentGameEntertainment/NovaShader

    Control Unity Editor Play Mode. An agent skill from CyberAgentGameEntertainment/NovaShader.

    1.6k GitHub starsUsed in 1 repo~1.3k tokens
    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

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.

    577 GitHub stars~2k tokensUpdated today
    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.

    577 GitHub stars~1.7k tokensUpdated today
    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.

    577 GitHub stars~2k tokensUpdated today
    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.

    577 GitHub stars~1.2k tokensUpdated today
    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.

    577 GitHub stars~228 tokensUpdated today
    Auto-check passed
  • Uloop Hello World

    hatayama/unity-cli-loop

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

    577 GitHub stars~321 tokensUpdated today
    Auto-check passed

Works with

Questions about Uloop Status

What does Uloop Status do?

Check whether the Unity Editor for this project can take a uloop command now, without side effects. Uloop Status is an agent skill from hatayama/unity-cli-loop. Check whether the Unity Editor for this project can take a uloop command now, without side effects.

When should I use Uloop Status?

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

How do I install Uloop Status in Claude Code?

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

How do I install Uloop Status in Codex?

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

Can I use Uloop Status 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-status -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-status, .gemini/skills/uloop-status, .github/skills/uloop-status and .opencode/skills/uloop-status in your project.

What does Uloop Status need to run?

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

Does Uloop Status 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 Status 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 Status use?

Uloop Status 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 Status use?

About 826 tokens (SKILL.md is roughly 3.3k 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 Status?

Skills that share tags, products or a category with Uloop Status: Fantasy Framework Development Guide (qq362946/Fantasy, 1.4k stars), Locus Unity Bridge (Misaka-Mikoto-Tech/agent-skills, 278 stars), Aibridge (FlameskyDexive/Legends-Of-Heroes, 929 stars) and Unity Skills (Besty0728/Unity-Skills, 1.8k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Uloop Status?

hatayama (a GitHub user) maintains it in hatayama/unity-cli-loop, which has 577 GitHub stars. The repository holds 11 skills in this directory. The repository was last updated on October 9, 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.