Unity Playmode Testing

What it does

When your agent uses it

• The user asks to run PlayMode tests with Domain Reload
• Simulate keyboard
• Inspect InputAction notifications in Play
• Preview method hot reload

Example prompts

• “/unity-playmode-testing”

Requirements

• Pre-approved tools (allowed-tools): Bash(unity-cli:*), Read, Grep, Glob

Workflow steps

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

1. 1Confirm editor state with get_editor_state before entering Play Mode or running tests.
2. 2Enter Play Mode or start tests, then wait until the runtime is ready before sending input.
3. 3Capture screenshots or short video only after the target state is visible.
4. 4Stop Play Mode or recording cleanly and report the final status.
5. 5If capture_screenshot returns "fallback": "os", the Editor did not respond (often a modal dialog). Inspect the desktop image, resolve the…

What it can do on your machine

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

• Tool permissions

  Pre-approves these tools, so the agent can use them without asking each time:

  • Bash(unity-cli:*)
  • Read
  • Grep
  • Glob

  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

Unity Playmode Testing loads about 2k tokens when it runs, and up to ~2.4k if it reads all its reference files. Until then it costs about 110 tokens; SKILL.md has 713 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~110

When it runs · the whole SKILL.md, loaded when a task matches

~2k

With references · SKILL.md plus every file in references/, read only if the agent opens them

~2.4k

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

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 akiojin/unity-cli at commit 7f45d7a, republished under its MIT licence (© akiojin). 713 words, ~1,988 tokens.

name

unity-playmode-testing

description

Drive Unity runtime verification with unity-cli. Use when the user asks to run PlayMode tests with Domain Reload, simulate keyboard, mouse, gamepad or touch input, inspect InputAction notifications in Play, record video or PNG frames, or preview method hot reload. Do not use for authoring input action assets; use `unity-input-system` instead. For URP and Bloom setup with before/after captures use `unity-urp-setup`.

allowed-tools

Bash(unity-cli:*), Read, Grep, Glob

metadata.author

akiojin

metadata.version

0.3.3

metadata.category

testing

metadata.triggers

playmode, editmode, test, simulate, screenshot, capture

metadata.siblings

unity-audio-setup, unity-localization, unity-2d-sprite-tilemap, unity-urp-setup, unity-ui-toolkit-build, unity-project-bootstrap, unity-input-system…

unity-cli raw play_game --json '{}'
unity-cli raw input_keyboard --json '{"key":"space","action":"press"}'
unity-cli raw capture_screenshot --json '{"captureMode":"game","width":1280,"height":720}'
unity-cli raw run_tests --json '{"testMode":"PlayMode"}'
unity-cli raw get_test_status --json '{}'
unity-cli raw stop_game --json '{}'

unity-cli raw input_keyboard --json '{"key":"space","action":"press","holdSeconds":0.2}'
unity-cli raw input_gamepad --json '{"action":"button","button":"a","buttonAction":"press","holdSeconds":0.2}'
unity-cli raw input_mouse --json '{"action":"move","x":100,"y":200,"absolute":true}'
unity-cli raw input_touch --json '{"action":"tap","x":100,"y":200,"touchId":0}'
unity-cli raw create_input_sequence --json '{"sequence":[{"type":"keyboard","params":{"action":"press","key":"space","holdSeconds":0.1}},{"type":"mouse","params":{"action":"move","x":100,"y":200,"absolute":true}}],"delayBetween":80}'
unity-cli raw get_input_actions_state --json '{"assetPath":"Assets/Input/Player.inputactions","includeBindings":true}'
unity-cli raw read_console --json '{"count":20}'

unity-cli raw capture_video_start --json '{"captureMode":"game","format":"png_sequence","width":320,"height":180,"fps":10,"maxDurationSec":0}'
unity-cli raw capture_video_status --json '{}'
unity-cli raw capture_video_stop --json '{}'

unity-cli raw run_tests --json '{"testMode":"PlayMode"}'
unity-cli raw get_test_status --json '{"includeTestResults":true}'

unity-cli raw hot_reload_status --json '{}'
unity-cli raw hot_reload --json '{"action":"begin","path":"Assets/HotReloadProbe.cs"}'
unity-cli raw hot_reload --json '{"action":"recover"}'

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

Files

SKILL.md and 2 other files (references) in .claude-plugin/plugins/unity-cli/skills/unity-playmode-testing of akiojin/unity-cli.

• SKILL.md
• references/playmode-test-loop.md
• references/runtime-checklist.md

Open the folder on GitHubat commit 7f45d7a