datnt-cell Unity Dev Workflow
Part of the Unity Skills plugin. This skill's batch module is the mechanism the protocol's batch execution step below uses.
Unity Skills protocol (quick reference)
This plugin talks to the Unity Editor through a local REST server. Before the first skill call in a session:
GET /health— discover the server (it binds a port in8090–8100). ReadcurrentMode("approval"/"auto"/"bypass") andsurfaceProfile(full/guide/noSceneAuthoring) — confirmprojectNamematches the project you're editing.- Under
approvalmode, the first write to aFullAutoskill returnsMODE_RESTRICTEDand needs a user grant; underauto/bypasswrites execute directly.
dryRun gate: before executing any skill whose exact parameters you don't already hold, call POST /skill/<name>?mode=dryRun and iterate until the response says valid:true — never guess parameters from a skill name alone. Then execute the same call without ?mode=dryRun.
Batch execution: when touching 2+ objects, prefer POST /skills/batch ({"steps":[{"skill","args"}],"continueOnError":false}, up to 50 steps per call, also supports ?mode=dryRun) over repeated single-item calls.
Error codes:
| Code | Meaning |
|---|---|
MODE_RESTRICTED / MODE_FORBIDDEN |
Needs a user grant, or needs Bypass/Allowlist. |
SURFACE_EXCLUDED |
Hidden by the current surfaceProfile — a configuration boundary, not a failure; don't retry or route around it. |
MISSING_PARAM / TARGET_NOT_FOUND |
Bad or unresolvable arguments — dryRun for the schema, locate the target first. |
For the full protocol detail, error code catalog, and guide-mode manual-* docs, optionally install the unity-core plugin — it's not required, this summary covers what you need for this skill.
Modules in this skill
| Module | Mode | Description | Doc |
|---|---|---|---|
| batch | SA | Batch and async jobs | modules/batch/SKILL.md |
| workflow | SA* | Task snapshots/undo, batch orchestration | modules/workflow/SKILL.md |
| debug | SA* | Compile/system diagnostics | modules/debug/SKILL.md |
| console | SA | Log capture/filter | modules/console/SKILL.md |
| profiler | SA | Perf statistics | modules/profiler/SKILL.md |
| history | SA | Undo/redo history | modules/history/SKILL.md |
| bookmark | SA | Scene View bookmarks | modules/bookmark/SKILL.md |
| test | Mixed* | Unity Test Runner | modules/test/SKILL.md |
| sample | Mixed* | Demo/test skills | modules/sample/SKILL.md |
| smart | FA* | Query/layout/auto-bind | modules/smart/SKILL.md |
| perception | SA | Scene/project analysis | modules/perception/SKILL.md |
| project | SA* | Project info/settings | modules/project/SKILL.md |
| event | Mixed* | UnityEvent wiring | modules/event/SKILL.md |
Mode legend: SA = runs without grant in all modes, FA = needs grant under Approval, Mixed = check per-skill, * = contains auto-forbidden skills.
Routing
Skills are named <module>_<verb>, except scene_analyze, hierarchy_describe, project_stack_detect → perception, and job_* → batch. Use debug/console to close the loop after any write from another unity-* skill — verify compilation and check for new errors before reporting success. Use workflow for multi-step task snapshots you may need to roll back as a unit, and batch (POST /skills/batch) for up to 50 steps per call when touching 2+ objects across any module in this plugin.
Open the matching module doc before calling any skill whose exact parameters you don't already hold — dryRun first.