unity-editor
Control and observe the Unity Editor state
How do I install this agent skill?
npx skills add https://github.com/besty0728/unity-skills --skill unity-editorIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The Unity Editor skill provides comprehensive control over a local Unity instance, including C# method invocation and menu execution. It presents a surface for indirect prompt injection as it ingests and processes Unity project state, asset journals, and console logs to automate tasks like runtime verification.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- Runlayerpass
1 file scanned · No issues
What does this agent skill do?
Unity Editor Skills
Observe and control the Unity Editor without parsing scene YAML: play mode, selection, undo and redo, change tracking, state and menu items. Parameters come from the schema (GET /skills/schema?category=Editor&wire=v2), never from a skill's name. Execution and dryRun rules: root SKILL.md.
When to use
- Reading persistent scene or file changes
- Driving play mode
- Inspecting runtime state
- Executing menu items
Rules
- Play-mode skills are NeverInSemi:
editor_play,editor_play_capture,editor_stop,editor_pauseandeditor_run_scenario(MayEnterPlayMode).editor_execute_menuis also NeverInSemi because reload-triggering items (Assets/Refresh,Assets/Reimport All) reload the domain. Under Approval and Auto they returnMODE_FORBIDDEN, and the grant flow does not apply. - Resume or file watching: when changes are reported, or the AI resumes after the user edited Unity, call
editor_get_changesbefore reading.unityYAML.dropped=truemeanssinceis older than the 500-entry window (retention); rebuild context withscene_contextorscene_diff. - Check
editor_get_statebefore play-mode work. Changes made during Play Mode are lost on exit. editor_play,editor_play_capture,editor_playmode_stepandeditor_run_scenarioreturn jobs; polljob_status. Neverjob_waiton a job that depends onEditorApplication.updateticks: it blocks the main thread those ticks need.editor_selectandeditor_playmode_inspecttake one ofname,entityId,instanceIdorpath; preferentityId.editor_get_contextreturns entityIds for batch work.editor_undoandeditor_redomake experiments reversible.- Pause on error belongs to the console module:
console_set_pause_on_error(console). - Routing: compilation check to
debug_check_compilation(debug); console errors todebug_get_errors; scene save toscene_save(scene).
Pitfalls
editor_execute_menuneeds the exact menu path. A miss returnsMenu item not found or failed: <path>, which the router reports asTARGET_NOT_FOUND; verify withgameobject_find,scene_get_hierarchyor the path spelling.SKILL_ERRORwithAlready in play mode,Not in play mode, or a frame-step job already active: enter or exit play mode first, or wait for the step job.editor_rundoes not exist: useeditor_play.editor_compileandeditor_recompiledo not exist: usedebug_force_recompile.editor_savedoes not exist: useeditor_execute_menuwith menuPath"File/Save".
Skills Overview
| Group | Skills |
|---|---|
| Play mode | editor_play, editor_play_capture, editor_stop, editor_pause, editor_playmode_step, editor_playmode_inspect |
| Verification | editor_run_scenario (invoke, read, assert and wait steps as one async job; repair loop: runtime verification) |
| Selection and undo | editor_select, editor_get_selection, editor_undo, editor_redo |
| State and changes | editor_get_context, editor_get_changes, editor_get_state, editor_get_tags, editor_get_layers |
| Menu | editor_execute_menu |
Per-skill tables, item fields and return shapes: reference/<skill_name>.md, rarely needed because the schema notes the parameters.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/besty0728/unity-skills/unity-editor">View unity-editor on skillZs</a>