Play Mode Testing

SkillMedia

Drive Unity runtime verification with unity-cli. Use when the user asks to enter or exit play-mode, run an editmode or playmode test, simulate keyboard, mouse, gamepad, or touch input, capture a screenshot or video, or inspect current test status. Do not use for authoring input action assets; use `unity-input-system` instead.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the Play Mode Testing skill

What this skill tells your AI

The instructions your AI receives, as published by akiojin/unity-cli in .claude-plugin/plugins/unity-cli/skills/unity-playmode-testing/SKILL.md and read by ahel’s review.

Control Play Mode, run EditMode/PlayMode tests, simulate input devices, and capture media. This skill is the runtime sibling of unity-input-system (asset authoring) and unity-ui-automation (UI interaction).

Use When

  • The user wants to run EditMode or PlayMode tests.
  • The task requires runtime input simulation.
  • The user wants screenshots or video from the current game or editor state.
  • The user wants to inspect current test progress or runtime state.

Do Not Use When

  • The task is editing input action assets; use unity-input-system.
  • The task targets only UI element interaction without runtime gameplay; use unity-ui-automation.
  • The work is purely static scene or code inspection; use the corresponding read-only skill.

Preferred Flow

  1. Confirm editor state with get_editor_state before entering Play Mode or running tests.
  2. Enter Play Mode or start tests, then wait until the runtime is ready before sending input.
  3. Capture screenshots or short video only after the target state is visible.
  4. Stop Play Mode or recording cleanly and report the final status.
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 '{}'

Examples

  • "Run PlayMode tests for the player flow and report the result."
  • "Enter Play Mode, press space, and capture a screenshot."
  • "Record a 5 second gameplay clip and stop automatically."

References

Signals

GitHub stars
103
Forks
12
Last commit
Aug 2026
Advanced
Catalog kind
skill
Gateway key
unity-playmode-testing
Source
github.com/akiojin/unity-cli