unity-workflow
Persistent operation history and orchestration
How do I install this agent skill?
npx skills add https://github.com/besty0728/unity-skills --skill unity-workflowIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill provides a set of tools for tracking and restoring operations within the Unity Editor, acting as an advanced undo/redo system. It includes capabilities for managing checkpoints, sessions, and individual tasks. High-risk operations like clearing history are explicitly restricted. No security issues were detected.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- Runlayerpass
1 file scanned · No issues
What does this agent skill do?
Unity Workflow Skills
Time Machine for AI operations: restoring a checkpoint undoes every tracked step after it, even across an Editor restart. Parameters: GET /skills/schema?category=Workflow&wire=v2.
When to use
- Undoing a restore, task, session or recent steps
- Naming a checkpoint before risky changes
Restore Protocol
- Call
workflow_restore {"to":"last"}(or ac<n>id or label). Without a conflict, that is the whole job. - On
WORKFLOW_CONFLICT, ask the user in one sentence which changes to keep; default to keeping them. - Resend with
"conflicts":"keep", or with theconflicts[].idvalues the user chose to overwrite. Any conflict not in your list is kept. ?mode=dryRunpreviews a restore without applying it.- To undo a restore, call
workflow_restore {"to":"<guard>"}with theguardfrom its response, orworkflow_redo_task, which reverts only that restore.
Checkpoints
- Automatic: a write that follows at least 30 s of idle time from its agent gets a checkpoint. Compile and reload time is not idle. The History tab switch turns them off; explicit ones still work.
_checkpoint: a body key on any write or on/skills/batch(its first recorded step):{"_checkpoint":"before lighting", ...}. A failed call leaves no checkpoint.workflow_checkpoint {label, at?}: withoutat, adds a checkpoint before the caller's next step; withat:"c343", renames one.
Restoring
workflow_restore {to, agents?, conflicts?, scope?}. to is a c<n> (back to that checkpoint), an s<n> (back to before that step), a label (the newest checkpoint with it), or last. agents is self (default) or all. scope limits it (see below).
Returns to, guard, restored, deleted, recreated, failed, skipped, coverage, undo, compileTriggered, and the optional merged, failedItems and skippedItems; see workflow_restore.
Errors: WORKFLOW_CONFLICT (nothing changed; conflicts lists each id, target, who and what), NOT_FOUND (with recentCheckpoints), SEMANTIC_INVALID (Play Mode, a bad agents, conflicts or scope value), COMPILING (retry after the compile).
An open scene's .unity is not rewritten; the scene is marked dirty, and saving applies the restore.
?mode=dryRun returns the preview in changes. workflow_undo_task, workflow_redo_task and workflow_session_undo share this engine and the same conflicts parameter.
Undoing One Step and Scope
workflow_undo_task {"taskId":"s342"} reverts one step. Later steps stay, even on the same object: the undo merges property by property.
scope keeps some targets: entity:<id>, object names or paths (trailing / adds children), Assets/ paths (trailing / = folder), or setting keys (trailing . = prefix). Example: {"to":"c343","scope":"Player/,Assets/Art/"}. A scoped restore marks no steps (undone). An item matching nothing returns SEMANTIC_INVALID with the targets. The dryRun preview lists danglingReferences for deleted objects still in use.
Known Limitations
- Conflict detection reads the change journal (about 22,000 entries). Once older entries rotate out,
coverageispartialorunknownand older changes are not checked. - Never-saved scene objects use session-local ids; they do not survive an Editor restart and restore as
failed. - External side effects (for example Package Manager operations) cannot be rolled back.
Skills Overview
| Skill | Purpose |
|---|---|
workflow_task_start | Start a tracked task |
workflow_task_end | End and save the task |
workflow_checkpoint | Name or rename a checkpoint |
workflow_snapshot_object | Snapshot an object (grant) |
workflow_snapshot_created | Record a created object (grant) |
workflow_restore | Restore to a checkpoint or step |
workflow_undo_task | Undo one step or group |
workflow_redo_task | Redo a restore |
workflow_undone_list | List redoable restores |
workflow_revert_task | Deprecated; use workflow_undo_task |
workflow_list | List tasks and checkpoints |
workflow_delete_task | Remove a task record (NeverInSemi) |
workflow_clear_history | Clear all history (NeverInSemi) |
history_undo | Undo the last operation(s) |
history_redo | Redo the last undone operation(s) |
history_get_current | Get the current undo group |
workflow_session_start | Start a session |
workflow_session_end | End and save the session |
workflow_session_undo | Undo a whole session |
workflow_session_list | List sessions |
workflow_session_status | Get session status |
workflow_plan | Build a combined plan |
bookmark_set | Save selection and Scene view (grant) |
bookmark_goto | Restore selection and Scene view (grant) |
bookmark_list | List bookmarks |
bookmark_delete | Delete a bookmark (NeverInSemi) |
Pitfalls
workflow_save,workflow_rollbackandworkflow_createdo not exist. Useworkflow_task_end,workflow_restoreandworkflow_task_start.- A single simple undo is
editor_undo.
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-workflow">View unity-workflow on skillZs</a>