Workflow Skills

Persistent history and rollback system for AI operations ("Time Machine"). Allows tagging tasks, snapshotting objects before modification, and undoing specific tasks even after Editor restarts.

NEW: Session-level undo - Group all changes from a conversation and undo them together.

Guardrails

Mode: Semi-Auto (available by default)

DO NOT (common hallucinations):

```
workflow_save
```
does not exist → use
```
workflow_task_end
```
to end and save a task

workflow_rollback

does not exist → use

workflow_undo_task

(by taskId) or

workflow_session_undo

(by sessionId)

```
workflow_create
```
does not exist → use
```
workflow_task_start
```
```
workflow_revert_task
```
is deprecated → use
```
workflow_undo_task
```

Routing:

For simple undo/redo (1 step) →
```
editor_undo
```
/
```
editor_redo
```
(editor module)
For multi-step undo →
```
history_undo
```
with
```
steps
```
parameter (this module)
For conversation-level undo →
```
workflow_session_undo
```
(this module)

Bookmark Skills

bookmark_set

Save current selection and scene view position as a bookmark.

Parameter	Type	Required	Default	Description
bookmarkName	string	Yes	-	Name for the bookmark
note	string	No	null	Optional note for the bookmark

Returns:

{ success, bookmark, selectedCount, hasSceneView, note }

bookmark_goto

Restore selection and scene view from a bookmark.

Parameter	Type	Required	Default	Description
bookmarkName	string	Yes	-	Name of the bookmark to restore

Returns:

{ success, bookmark, restoredSelection, note }

bookmark_list

List all saved bookmarks.

No parameters.

Returns:

{ success, count, bookmarks: [{ name, selectedCount, hasSceneView, note, createdAt }] }

bookmark_delete

Delete a bookmark.

Parameter	Type	Required	Default	Description
bookmarkName	string	Yes	-	Name of the bookmark to delete

Returns:

{ success, deleted }

History Skills

history_undo

Undo the last operation (or multiple steps).

Parameter	Type	Required	Default	Description
steps	int	No	1	Number of undo steps to perform

Returns:

{ success, undoneSteps }

history_redo

Redo the last undone operation (or multiple steps).

Parameter	Type	Required	Default	Description
steps	int	No	1	Number of redo steps to perform

Returns:

{ success, redoneSteps }

history_get_current

Get the name of the current undo group.

No parameters.

Returns:

{ success, currentGroup, groupIndex }

Planning And Batch Governance

workflow_plan

Generate a combined execution plan for multiple skills on the server side.

Parameter	Type	Required	Default	Description
`skillsJson`	string	Yes	-	JSON array of `{ "name": "...", "params": { ... } }` entries

Returns:

{ totalSteps, totalRisk, steps, dependencies, warnings, mayDisconnect }

batch_query_assets

Query project assets with filters that are useful before batch cleanup or migration work.

Parameter	Type	Required	Default	Description
`searchFilter`	string	No	-	Extra `AssetDatabase.FindAssets` filter text
`folder`	string	No	`Assets`	Search root
`typeFilter`	string	No	-	Asset type filter such as `t:Material` or `Prefab`
`namePattern`	string	No	-	Regex applied to file name without extension
`labelFilter`	string	No	-	Asset label filter such as `l:Addressable`
`maxResults`	int	No	`200`	Max assets returned

Returns:

{ count, totalMatched, summary, assets }

batch_retry_failed

Retry only the failed items from an earlier batch execution report. This now reuses the original operation context stored in the report.

Parameter	Type	Required	Default	Description
`reportId`	string	Yes	-	Source report ID from `batch_report_get` / `batch_report_list`
`runAsync`	bool	No	`true`	Return a `jobId` immediately or wait for completion
`chunkSize`	int	No	`100`	Chunk size for retry execution

Returns:

{ status, jobId?, retryCount, originalReportId, reportId? }

Session Management (Conversation-Level Undo)

workflow_session_start

Start a new session (conversation-level). All changes will be tracked and can be undone together. Call this at the beginning of each conversation.

Parameter	Type	Required	Default	Description
tag	string	No	null	Label for the session

Returns:

{ success, sessionId, message }

workflow_session_end

End the current session and save all tracked changes. Call this at the end of each conversation.

No parameters.

Returns:

{ success, sessionId, message }

workflow_session_undo

Undo all changes made during a specific session (conversation-level undo).

Parameter	Type	Required	Default	Description
sessionId	string	No	null	The UUID of the session to undo. If not provided, undoes the most recent session

Returns:

{ success, sessionId, message }

workflow_session_list

List all recorded sessions (conversation-level history).

No parameters.

Returns:

{ success, count, currentSessionId, sessions: [{ sessionId, taskCount, totalChanges, startTime, endTime, tags }] }

workflow_session_status

Get the current session status.

No parameters.

Returns:

{ success, hasActiveSession, currentSessionId, isRecording, currentTaskId, currentTaskTag, currentTaskDescription, snapshotCount }

Task-Level Skills

workflow_task_start

Start a new persistent workflow task to track changes for undo. Call workflow_task_end when done.

Parameter	Type	Required	Default	Description
tag	string	Yes	-	Short label for the task (e.g., "Create NPC")
description	string	No	""	Detailed description or prompt

Returns:

{ success, taskId, message }

workflow_task_end

End the current workflow task and save it. Requires an active task (call workflow_task_start first).

No parameters.

Returns:

{ success, taskId, snapshotCount, message }

workflow_snapshot_object

Manually snapshot an object's state before modification. Requires an active task (call workflow_task_start first). Call this BEFORE
component_set_property
,
gameobject_set_transform
, etc.

Parameter	Type	Required	Default	Description
name	string	No	null	Name of the Game Object
instanceId	int	No	0	Instance ID of the object (preferred)

Returns:

{ success, objectName, type }

workflow_snapshot_created

Record a newly created object for undo tracking. Requires an active task (call workflow_task_start first). Note:

component_add

and

gameobject_create

automatically record created objects, so you typically don't need to call this manually.

Parameter	Type	Required	Default	Description
name	string	No	null	Name of the Game Object
instanceId	int	No	0	Instance ID of the object (preferred)

Returns:

{ success, objectName, type }

workflow_list

List persistent workflow history.

No parameters.

Returns:

{ success, count, history: [{ id, tag, description, time, changes }] }

workflow_undo_task

Undo changes from a specific task (restore to previous state). The undone task is saved and can be redone later.

Parameter	Type	Required	Default	Description
taskId	string	Yes	-	The UUID of the task to undo

Returns:

{ success, taskId }

workflow_redo_task

Redo a previously undone task (restore changes).

Parameter	Type	Required	Default	Description
taskId	string	No	null	The UUID of the task to redo. If not provided, redoes the most recently undone task

Returns:

{ success, taskId }

workflow_undone_list

List all undone tasks that can be redone.

No parameters.

Returns:

{ success, count, undoneStack: [{ id, tag, description, time, changes }] }

workflow_revert_task

(deprecated) Alias for

workflow_undo_task

. Use

workflow_undo_task

instead.

Parameter	Type	Required	Default	Description
taskId	string	Yes	-	The UUID of the task to undo

Returns:

{ success, taskId }

workflow_delete_task

Delete a task from history (does not revert changes, just removes the record).

Parameter	Type	Required	Default	Description
taskId	string	Yes	-	The UUID of the task to delete

Returns:

{ success, deletedId }

Minimal Example

python

import unity_skills

# Session-level: wrap entire conversation for bulk undo
unity_skills.call_skill("workflow_session_start", tag="Build Player")
unity_skills.call_skill("gameobject_create", name="Player", primitiveType="Capsule")
unity_skills.call_skill("component_add", name="Player", componentType="Rigidbody")
unity_skills.call_skill("workflow_session_end")
# Later: undo entire session
sessions = unity_skills.call_skill("workflow_session_list")
unity_skills.call_skill("workflow_session_undo", sessionId=sessions["sessions"][0]["sessionId"])

Auto-Tracked Operations

The following operations are automatically tracked for undo when a session/task is active:

gameobject_create

gameobject_create_batch

gameobject_duplicate

gameobject_duplicate_batch

```
component_add
```
/
```
component_add_batch
```
```
ui_create_*
```
(canvas, button, text, image, etc.)
```
light_create
```

prefab_instantiate

prefab_instantiate_batch

```
material_create
```
/
```
material_duplicate
```
```
terrain_create
```
```
cinemachine_create_vcam
```

For modification operations, the system auto-snapshots target objects before changes when possible.

Exact Signatures

Exact names, parameters, defaults, and returns are defined by

GET /skills/schema

unity_skills.get_skill_schema()

, not by this file.

unity-workflow

NPX Install

Tags

SKILL.md Content

Workflow Skills

Guardrails

Bookmark Skills

`bookmark_set`

`bookmark_goto`

`bookmark_list`

`bookmark_delete`

History Skills

`history_undo`

`history_redo`

`history_get_current`

Planning And Batch Governance

`workflow_plan`

`batch_query_assets`

`batch_retry_failed`

Session Management (Conversation-Level Undo)

`workflow_session_start`

`workflow_session_end`

`workflow_session_undo`

`workflow_session_list`

`workflow_session_status`

Task-Level Skills

`workflow_task_start`

`workflow_task_end`

`workflow_snapshot_object`

`workflow_snapshot_created`

`workflow_list`

`workflow_undo_task`

`workflow_redo_task`

`workflow_undone_list`

`workflow_revert_task`

`workflow_delete_task`

Minimal Example

Auto-Tracked Operations

Exact Signatures