Agent skill

Uloop Record Video

by hatayama in hatayama/unity-cli-loop

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

MITAuto-check passedGame Development

Install Uloop Record Video

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

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

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

At a glance

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

  • Works in 6 steps: For a Game View recording, ensure Play… → uloop record-video --action start… → Drive the scene with other uloop… → …
  • A screenshot is not enough: motion
  • SKILL.md covers Workflow, Tool Reference, Output and Interpreting results, plus 1 more section
  • Calls ffmpeg

What it does

Uloop Record Video is an agent skill from hatayama/unity-cli-loop. Record the Game View or any Editor window (Scene, Inspector, ...) to an .mp4 or .webm video. Use when a screenshot is not enough: motion, animation, physics, or a gameplay sequence.

Its SKILL.md is about 1.7k 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

  • A screenshot is not enough: motion
  • A gameplay sequence

Example prompts

  • “/uloop-record-video”

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. For a Game View recording, ensure Play Mode is running (uloop control-play-mode --action Play) and the Game View is open; start fails in…
  2. uloop record-video --action start [options]. It returns immediately; encoding continues inside the Editor.
  3. Drive the scene with other uloop commands (simulate-keyboard, simulate-mouse-input, replay-input, ...). Do not run uloop compile…
  4. uloop record-video --action stop. The file is playable only after this call (or after an auto-stop).
  5. Read OutputPath from the JSON and use exactly that path. The output directory holds earlier recordings too (the newest 20 per extension…
  6. To inspect the content yourself, extract stills with ffmpeg (e.g. ffmpeg -i "" -vf fps=1 frames_%03d.png) and view the PNGs. Otherwise…

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

    Shell commands in SKILL.md call:

    • ffmpeg

    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 Record Video loads about 1.7k tokens when it runs. Until then it costs about 50 tokens; SKILL.md has 869 words of instructions outside code blocks.

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

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). 869 words, ~1,716 tokens.

Download SKILL.mdSave it as .claude/skills/uloop-record-video/SKILL.md (or your agent's skills folder).
name
uloop-record-video
description
Record the Game View or any Editor window (Scene, Inspector, ...) to an .mp4 or .webm video. Use when a screenshot is not enough: motion, animation, physics, or a gameplay sequence.
toolName
record-video

Task

Record the Unity Game View while Play Mode is running, or any Editor window with --window-name, then hand the file path to the user or inspect frames from it.

Workflow

  1. For a Game View recording, ensure Play Mode is running (uloop control-play-mode --action Play) and the Game View is open; start fails in Edit Mode. With --window-name the recording targets that Editor window instead and needs no Play Mode.
  2. uloop record-video --action start [options]. It returns immediately; encoding continues inside the Editor.
  3. Drive the scene with other uloop commands (simulate-keyboard, simulate-mouse-input, replay-input, ...). Do not run uloop compile mid-recording: a compile that runs auto-stops and finalizes the file (when Unity's Script Changes While Playing is Recompile After Finished Playing, the compile is refused instead and the recording continues). Exiting Play Mode also auto-stops a Game View recording; a --window-name recording keeps running when Play Mode stops.
  4. uloop record-video --action stop. The file is playable only after this call (or after an auto-stop).
  5. Read OutputPath from the JSON and use exactly that path. The output directory holds earlier recordings too (the newest 20 per extension are kept), so ls -t can pick a stale file.
  6. To inspect the content yourself, extract stills with ffmpeg (e.g. ffmpeg -i "<OutputPath>" -vf fps=1 frames_%03d.png) and view the PNGs. Otherwise report the path and duration to the user.

Tool Reference

bash
uloop record-video --action start [--frame-rate <fps>] [--max-duration-seconds <sec>] [--resolution-scale <0.1-1.0>] [--quality <low|medium|high>] [--window-name <name>] [--match-mode <exact|prefix|contains>] [--output-path <file>]
uloop record-video --action status
uloop record-video --action stop
Parameters
ParameterTypeDefaultDescription
--actionenumstartstart - begin recording, stop - finalize the file, status - report progress
--frame-rateinteger30Output video fps. Valid range 1–60. Frames are paced by wall-clock time; when the Editor renders slower than this, the previous frame is repeated. Used by start only.
--max-duration-secondsinteger60Auto-stop safety limit in seconds. Valid range 1–600. Used by start only.
--resolution-scalenumber1.0Resolution scale (0.1 to 1.0) applied to the Game View size before encoding. 0.5 cuts file size and encoding cost to about a quarter. Used by start only.
--qualityenummediumEncoder bitrate preset: low, medium, or high. Used by start only.
--window-namestringemptyEditor window title to record instead of the Game View (for example Scene, Inspector, Console). Empty records the Game View and requires Play Mode. A window recording does not require Play Mode, brings the tab to the front, repaints it every frame, and keeps running when Play Mode stops. Used by start only.
--match-modeenumexactWindow title matching for --window-name: exact, prefix, or contains (case-insensitive). Used by start only.
--output-pathstringemptyOutput file path. Empty uses .uloop/outputs/Videos/gameview_<yyyyMMdd_HHmmss_fff>.mp4 (.webm on Linux). Extension must be .mp4 (H.264) or .webm (VP8). Linux rejects .mp4. Used by start only.
Actions
ActionBehaviorTypical use
startValidates, opens the encoder, returns. One recording at a time; a second start fails until stop.Begin capture before driving input
statusReports live counters. When idle, reports the most recent auto-stopped recording.Check progress or find out why a recording ended
stopFinalizes the file and returns the final counters. When nothing is recording, returns the last auto-stopped recording once, then "No recording is in progress."End capture
Show full SKILL.md (354 more words)Show less

Output

Returns JSON containing:

  • Success: Whether the request completed.
  • Message: Human-readable status.
  • Action: Echoes the executed action.
  • IsRecording: Whether a recording is active after this call.
  • OutputPath: Absolute path of the video file. Open this path; do not search the directory. A window recording uses the window_ name prefix instead of gameview_.
  • Width / Height: Encoded resolution after --resolution-scale and even rounding (0 when none).
  • FrameRate: Output fps (0 when none).
  • Quality: Bitrate preset in use.
  • EncodedFrameCount: Frames written to the encoder.
  • SkippedFrameCount: Frame slots that could not be captured (Game View closed or resized, or encoder refused a frame). The video keeps its timeline; skipped slots are simply missing.
  • ElapsedSeconds: Seconds since start (frozen after stop).
  • StoppedBy: Why the recording ended — "cli", "max-duration", "play-mode-exit", "window-closed", "assembly-reload", or "editor-quit". Omitted while recording.

Interpreting results

  • Success: false with Message "A recording is already in progress" → run stop first, then start again.
  • Success: false with "Play Mode view RenderTexture is not available" → open the Game View tab (uloop focus-window) and make sure a camera renders.
  • SkippedFrameCount growing while EncodedFrameCount stays flat → the Game View is closed, hidden, or resized. Restore it; recording resumes without restarting.
  • EncodedFrameCount far below ElapsedSeconds × FrameRate with few skips → the Editor is unfocused and throttling draws; run uloop focus-window before the next recording.
  • Success: false with "Window '...' not found" → pick the right title from the Open windows: list in the message, or use --match-mode prefix.
  • StoppedBy is not "cli" → the recording ended on its own; the file is still valid up to that point.

Notes

  • Odd Game View sizes are rounded down to even for H.264 (for example 1286×723 → 1286×722; the last pixel row/column is dropped).
  • The recording is wall-clock paced, so Play Mode pause records a still image, not a gap.
  • A window recording survives Play Mode stopping, but entering Play Mode with domain reload enabled (Unity's default) ends it with StoppedBy: "assembly-reload".
  • Default output is H.264 .mp4 on macOS/Windows and VP8 .webm on Linux. An explicit .webm path uses VP8 on every host.
  • Default recordings under .uloop/outputs/Videos/ keep only the newest 20 files per extension; a custom --output-path is never pruned.

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

Open the folder on GitHubat commit b05bd95

Compare with similar skills

Uloop Record Video 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 Record Video compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Uloop Record Video this skillhatayama/unity-cli-loop577—~1.7kAutomated 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 yesterday
    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 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
  • Uloop Compile

    hatayama/unity-cli-loop

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

    577 GitHub stars~1.3k tokensUpdated today
    Auto-check passed

Works with

Questions about Uloop Record Video

What does Uloop Record Video do?

Record the Game View or any Editor window (Scene, Inspector, ...) to an .mp4 or .webm video. Uloop Record Video is an agent skill from hatayama/unity-cli-loop.webm video.

When should I use Uloop Record Video?

Uloop Record Video fits situations like: A screenshot is not enough: motion; A gameplay sequence.

How do I install Uloop Record Video in Claude Code?

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

How do I install Uloop Record Video in Codex?

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

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

What does Uloop Record Video need to run?

Going by SKILL.md and its folder, Uloop Record Video needs the command-line tools its instructions call (ffmpeg).

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

Uloop Record Video 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 Record Video use?

About 1.7k tokens (SKILL.md is roughly 6.9k 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 Record Video?

Skills that share tags, products or a category with Uloop Record Video: 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 Record Video?

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.