unity-workflow

Tracks, snapshots, and rolls back Unity Editor operations across sessions.

Updated Aug 18, 2026
One-click install
npx skills add https://github.com/ethanJPope/Our-Main-Hackathon-Game --skill unity-workflow-ethanjpope
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unity-workflow
Source: https://github.com/ethanJPope/Our-Main-Hackathon-Game/tree/main/.agents/skills/unity-skills/skills/workflow
Command: npx skills add https://github.com/ethanJPope/Our-Main-Hackathon-Game --skill unity-workflow-ethanjpope

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? AI-driven Unity edits are hard to reverse: once objects are created, modified, or deleted, there is no reliable way to undo a whole batch of changes, especially after the Editor restarts. This Skill provides persistent operation history, task/session grouping, and snapshot-based rollback for Unity Editor automation. ## Core Features & Use Cases - Persistent Task & Session Undo: Group changes into tasks or conversation-level sessions, then undo or redo them by ID even after Editor restarts. - Snapshot-Based Rollback: Automatically snapshots created, moved, deleted, and modified assets (including .cs scripts and settings) into a content-addressed store for full restoration. - Planning & Batch Governance: Generate combined execution plans with workflow_plan, query assets before batch cleanup, and retry only failed batch items. - Use Case: Before letting an AI refactor a scene, call workflow_session_start, let it create GameObjects and add components, then call workflow_session_end. If the result is wrong, undo everything at once with workflow_session_undo. ## Quick Start Start a workflow session, make your Unity scene changes, then undo the entire session by its ID if anything goes wrong.

Frequently Asked Questions about unity-workflow

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I undo multiple Unity Editor operations at once?

Use history_undo with a steps parameter for multi-step undo, or group changes into a task with workflow_task_start and reverse them with workflow_undo_task. For conversation-level rollback, use workflow_session_undo with the session ID.

How to roll back AI-made changes in Unity after Editor restart?

Workflow history is persisted to workflow_history.json with content-addressed file backups, so tasks survive Editor restarts. Call workflow_list to find the task ID, then workflow_undo_task to restore the previous state.

Does Unity workflow undo restore deleted C# scripts?

Yes. Deleted assets, including .cs scripts and their .meta files, are moved into a content-addressed store and fully restored on undo. Modified assets are restored from backed-up bytes.

What is the difference between editor_undo and workflow_undo_task?

editor_undo handles a single immediate undo step, while workflow_undo_task reverses an entire recorded task by ID, even across sessions. Use history_undo for multi-step undo and workflow_session_undo for conversation-level rollback.

Why does workflow undo fail for objects in unsaved scenes?

Objects created in a never-saved scene have GlobalObjectIds that become invalid after an Editor restart, so undo marks them as failed. External side effects like Package Manager operations also cannot be rolled back.

Can I clear all Unity workflow history safely?

workflow_clear_history permanently deletes all tasks, the redo stack, and stored file backups; it is high-risk and blocked in Approval/Auto modes. It does not revert applied changes, so undo tasks first if you need rollback.