unity-workflow

Tracks, snapshots, and rolls back Unity Editor operations with persistent task and session history.

Updated Aug 31, 2026
One-click install
npx skills add https://github.com/pikachu0310/codex-agent-ops-public --skill unity-workflow-pikachu0310
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unity-workflow
Source: https://github.com/pikachu0310/codex-agent-ops-public/tree/main/.agents/skills/unity-skills/skills/workflow
Command: npx skills add https://github.com/pikachu0310/codex-agent-ops-public --skill unity-workflow-pikachu0310

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? AI-driven Unity edits are hard to reverse once applied, especially across Editor restarts or long conversations. This Skill records every operation as a persistent, snapshot-backed task so entire tasks or sessions can be undone, redone, or audited later. ## Core Features & Use Cases - Persistent task and session undo: Group changes into tasks or conversation-level sessions, then undo or redo them even after the Unity Editor restarts. - Content-addressed snapshots: Automatically backs up assets, scenes, materials, and settings before modification, with full restore including deleted .cs scripts. - Planning and 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, start a session with workflow_session_start, let it create GameObjects and add components, then call workflow_session_undo to revert everything if the result is wrong. ## Quick Start Start a workflow session, make your Unity scene changes, then list sessions and undo the most recent one to roll everything back.

Frequently Asked Questions about unity-workflow

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

FAQPage Schema
How do I undo all changes from an AI conversation in Unity?

Call workflow_session_start at the beginning of the conversation and workflow_session_end when done. Later, use workflow_session_list to find the sessionId and call workflow_session_undo to revert every tracked change from that session at once.

How to undo a specific task in Unity Editor after restart?

Workflow history is persisted to workflow_history.json, so tasks survive Editor restarts. Call workflow_list to get the taskId, then workflow_undo_task with that ID to restore the previous state; the undone task can be redone later.

Does Unity workflow undo restore deleted C# scripts?

Yes. Deleted assets, including .cs scripts, are moved into a content-addressed file store with their .meta files, so undo performs a full restore. Asset and meta bytes are stored by SHA1 hash under Library/UnitySkills/workflow_files.

Why does workflow_clear_history return MODE_FORBIDDEN?

workflow_clear_history is marked as a high-risk Delete operation, so it is NeverInSemi and forbidden in Approval or Auto modes. It only runs in Bypass mode or when an allowlist entry matches, because it irreversibly wipes all history and stored backups.

What are the limitations of Unity workflow undo?

Undoing scene_save restores the on-disk .unity file, but an open scene must be reloaded to take effect. Objects created in never-saved scenes fail undo after restart, and external side effects like Package Manager operations cannot be rolled back.