Use this skill when the user wants to automate the Unity Editor through the local UnitySkills REST server.
Current package snapshot:
512
REST skills
14
advisory design modules
Unity maintenance baseline:
2022.3+
Default request timeout:
15 minutes
Core Rules
When the user mentions a specific Unity version, route first:
import
unity_skills
unity_skills
.
set_unity_version
(
"2022.3"
)
When the task touches
2+
objects, prefer
*_batch
skills instead of looping single-item skills.
When the task spans multiple editor mutations, prefer a workflow wrapper:
import
unity_skills
with
unity_skills
.
workflow_context
(
"build_scene"
,
"Create player and camera"
)
:
unity_skills
.
call_skill
(
"gameobject_create"
,
name
=
"Player"
,
primitiveType
=
"Capsule"
)
unity_skills
.
call_skill
(
"camera_create"
,
name
=
"MainCamera"
,
x
=
0
,
y
=
2
,
z
=
-
6
)
Script creation, script edits, define changes, package changes, some asset reimports, and test-template creation may trigger compilation or Domain Reload. During those windows the server can be temporarily unavailable. Wait and retry instead of assuming a fatal failure.
The
test_*
skills wrap Unity Test Runner async jobs inside the current editor instance. They return a
jobId
that should be polled with
test_get_result(jobId)
.
Python Helper
Main helper file:
unity-skills/scripts/unity_skills.py
Common helpers:
import
unity_skills
unity_skills
.
call_skill
(
"gameobject_create"
,
name
=
"Cube"
,
primitiveType
=
"Cube"
)
unity_skills
.
call_skill_with_retry
(
"asset_refresh"
)
unity_skills
.
wait_for_unity
(
timeout
=
10
)
print
(
unity_skills
.
list_instances
(
)
)
print
(
unity_skills
.
get_server_status
(
)
)
Script workflow helper:
import
unity_skills
result
=
unity_skills
.
create_script
(
"PlayerController"
)
if
result
.
get
(
"success"
)
:
print
(
result
.
get
(
"compilation"
)
)
Advisory Design Modules
These modules are optional. Load them when the user asks for architecture guidance, script design advice, refactoring direction, coupling reduction, performance review, maintainability tradeoffs, or XR/VR/AR development (grab interactions, teleportation, controller setup).
skills/project-scout/SKILL.md
skills/architecture/SKILL.md
skills/adr/SKILL.md
skills/performance/SKILL.md
skills/asmdef/SKILL.md
skills/blueprints/SKILL.md
skills/script-roles/SKILL.md
skills/scene-contracts/SKILL.md
skills/testability/SKILL.md
skills/patterns/SKILL.md
skills/async/SKILL.md
skills/inspector/SKILL.md
skills/scriptdesign/SKILL.md
skills/xr/SKILL.md
Use them on demand. Do not default to giant architecture dumps, forced UniTask adoption, or a global event bus unless the project context clearly justifies it.
XR/VR rule
Before calling any
xr_*
skill for the first time in a session,
always load
skills/xr/SKILL.md
first
. It contains verified API property names, Collider configuration rules, and anti-hallucination guardrails that prevent common setup errors. Skipping this step risks silent configuration failures.
Module Index
For module-by-module documentation, open:
unity-skills/skills/SKILL.md
For script-specific guidance, open:
unity-skills/skills/script/SKILL.md