SkillAgentSearch skills...

unity-workflow

Persistent operation history and orchestration

Install / Use

npx skills add Besty0728/Unity-Skills --skill workflow

Installs into whichever agent you are using.

About this skill
📄

SKILL.md

Installable skill definition

Quality Score

84/100

Category

Automation

Supported Platforms

Universal

Our assessment of unity-workflow

unity-workflow scores 84/100 on our quality scale, 2069th of 2,790 Automation skills we index.

Its SKILL.md is 16 KB long, well organised into 43 sections with 1 code example: a thorough specification that gives an agent plenty to work with.

With 1,781 GitHub stars, it is one of the more widely adopted skills in the catalogue.

Substance
30/30
Structure
17/20
Description
8/15
Adoption
14/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated about 2 months ago, so unity-workflow is actively maintained.
  • Our last check on 2026-10-14 found the source still online.
  • It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
  • Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.

AI review by kimi-k2.7-code on 2026-10-01. Automated pattern scan on 2026-10-01. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

unity-workflow compared with similar skills

All 4 of these similar skills score higher than unity-workflow; compare them before choosing.

SkillScoreStarsUpdatedFormat
unity-workflow (this skill)by Besty0728841.8k53d agoSKILL.md
Agent-Reachby Panniantong100112.3k8d agoCLAUDE.md
rufloby ruvnet10081.9ktodayCLAUDE.md
Claude-Code-Game-Studiosby Donchitos10039.7k7d agoCLAUDE.md
Scraplingby D4Vinci100103.6k2d agoMCP Server

Frequently asked questions

How do I install unity-workflow?
Run npx skills add Besty0728/Unity-Skills --skill unity-workflow. The install tabs above show the steps for each supported agent.
Which AI agents does unity-workflow work with?
It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
Is unity-workflow safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is unity-workflow still maintained?
The repository was last updated about 2 months ago, so unity-workflow is actively maintained.

name: unity-workflow description: Persistent operation history and orchestration

Before calling any skill in this module: if you are about to call a skill with parameters guessed from its name or description, STOP — read this file (or fetch its schema via GET /skills/recommend?includeSchema=true) first. If you already have the parameter definitions from recommend/schema, you may proceed straight to dryRun.

Triggers

  • Undoing a whole task or session
  • Snapshotting before risky changes
  • Planning/previewing batch operations
  • Rolling back
  • 撤销整个任务或会话、高危改动前快照、规划/预览批量操作、回滚

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.

Operating Mode

  • Approval:本模块大部分 skill 标 SkillMode.SemiAuto(bookmark / history / task / session 系列里的纯读查询 + workflow_plan,后者 ReadOnly=true 仅生成聚合计划),可直接执行。有副作用的 skill (bookmark_set / bookmark_goto / workflow_snapshot_object / workflow_snapshot_created / batch_retry_failed) 走默认 SkillMode.FullAuto,需 grant。
  • Auto / Bypass:FullAuto 直接执行。
  • 含 NeverInSemi 高危 skill:bookmark_delete / workflow_delete_task(标 Operation.Delete,删除书签/任务记录)、workflow_clear_history(Operation.Delete + RiskLevel=high,清空全部历史+redo栈+文件存储,不可逆)。这些在 Approval/Auto 下返 MODE_FORBIDDEN,仅 Bypass 或 Allowlist 命中可调。

注意:workflow_undo_task / workflow_session_undo 不是 Delete operation(标的是 Modify/Execute),它们能在 Approval/Auto 直接撤销已记录任务。

Surface profile: workflow_undo_task / workflow_redo_task / workflow_revert_task / workflow_session_undo inspect every snapshot the target task(s) would restore. If any snapshot would author a category the active profile withdraws — a scene GameObject, or a .unity / .mat asset — the whole call is refused with SURFACE_EXCLUDED (surfaceProfile/category/operation/manualDoc/userControlled/hint at the top level, not nested under details) rather than partially applied. Snapshots of scripts, prefabs, textures, ScriptableObjects, and Editor/project settings are unaffected — those stay undoable under every profile.

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 }

workflow_clear_history

Permanently clear ALL workflow history: every task, the redo (undone) stack, and every backed-up file blob in the content-addressed store. High-risk and irreversible. This ONLY deletes tracking history — it does NOT undo or revert any change already applied to your project assets, scenes, or settings. To roll changes back, use workflow_undo_task / workflow_session_undo before clearing.

Marked SkillOperation.Delete + RiskLevel="high", so it is NeverInSemi (returns MODE_FORBIDDEN in Approval/Auto; only Bypass or an Allowlist hit ca

Truncated for display — read the full file on GitHub.

Related Skills

View on GitHub
GitHub Stars1.8k
CategoryAutomation
Updated1mo ago
Forks165

Languages

C#

Trust signals

100/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

No cautions