unity-editor

Control and observe Unity Editor state, play mode, selection, and menu commands.

Updated Aug 18, 2026
One-click install
npx skills add https://github.com/ethanJPope/Our-Main-Hackathon-Game --skill unity-editor-ethanjpope
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unity-editor
Source: https://github.com/ethanJPope/Our-Main-Hackathon-Game/tree/main/.agents/skills/unity-skills/skills/editor
Command: npx skills add https://github.com/ethanJPope/Our-Main-Hackathon-Game --skill unity-editor-ethanjpope

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? AI agents working with Unity projects need to observe and drive the Unity Editor without parsing raw scene YAML files. This Skill exposes structured operations for reading editor state, tracking persistent scene and file changes, driving Play Mode, and executing menu commands. ## Core Features & Use Cases - Editor State Observation: Query play/pause/compile state, selection, full editor context, tags, and layers through structured responses. - Play Mode Control: Enter, pause, step frame-by-frame, capture runtime errors and screenshots, and inspect live GameObject state during Play Mode. - Change Tracking: Read a persistent change journal via cursor-based polling to detect scene and asset modifications across domain reloads. - Use Case: After a user edits the Unity project externally, call editor_get_changes with the saved cursor to see what changed, then use editor_playmode_inspect to verify a GameObject's runtime transform during Play Mode. ## Quick Start Ask the AI to check the Unity Editor state and list any scene changes since the last session before entering Play Mode.

Frequently Asked Questions about unity-editor

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I control Unity Play Mode from an AI agent?

Use editor_play to enter Play Mode, editor_pause to toggle pause, editor_playmode_step to advance specific frames, and editor_stop to exit. Play Mode entry returns a jobId that you poll with job_status to confirm completion.

How to track Unity scene changes without parsing YAML files?

Call editor_get_changes with a cursor parameter to read the persistent change journal at Library/UnitySkills/editor_changes.jsonl. It returns scene object, component, and asset changes across domain reloads without exposing raw .unity YAML.

Can I inspect GameObject state while Unity is playing?

Yes, editor_playmode_inspect returns a GameObject's transform, active state, and component fields during Play Mode, including while paused. It also works in Edit Mode, with isPlaying and isPaused flags indicating which state the values reflect.

Why does editor_playmode_step fail or time out?

The step skill requires Play Mode to already be active and only one step job can run at a time. Poll with job_status instead of job_wait, since job_wait blocks the main thread that produces the editor ticks the job depends on.

What are the limitations of executing Unity menu commands programmatically?

editor_execute_menu requires the exact menu path string, and typos cause silent failure. Menu items like Assets/Refresh that trigger domain reloads are flagged high-risk and forbidden in Approval and Auto modes unless allowlisted.