checkpoint-manager

Parse recovery commands from execution_trace.md and restore project state to a Git hash.

Updated Apr 20, 2026
One-click install
npx skills add https://github.com/ddmanyes/antigravity-skills-zht --skill checkpoint-manager-ddmanyes
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: checkpoint-manager
Source: https://github.com/ddmanyes/antigravity-skills-zht/tree/main/skills/checkpoint-manager
Command: npx skills add https://github.com/ddmanyes/antigravity-skills-zht --skill checkpoint-manager-ddmanyes

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill parses recovery commands from execution_trace.md and restores the project state to a specific Git hash, enabling precise rollbacks and state resets.

Core Features & Use Cases

  • Recovery command parsing from execution_trace.md to identify target hash and step.
  • Git-based state restoration using git checkout to revert to a historical checkpoint.
  • Context realignment by reading IMPLEMENTATION_PLAN.md in the restored state and adjusting active task pointers.
  • Safety prompts for uncommitted changes to prevent accidental data loss.

Quick Start

指定要回溯的 Git hash 與步驟名稱,系統將執行回溯並重置上下文。

Frequently Asked Questions about checkpoint-manager

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

FAQPage Schema
How do I restore my project state to a specific Git hash?

To restore your project state to a specific Git hash, this Skill parses recovery commands from execution_trace.md and uses git checkout to revert. It reads IMPLEMENTATION_PLAN.md from the restored state to realign active task pointers.

How does execution_trace.md work for step-based progress resets?

Execution_trace.md works for step-based progress resets by providing the target Git hash and step name. The Skill parses these recovery commands to execute a safe checkout and sync the project context to that historical checkpoint.

Can I rollback uncommitted Git changes without losing data?

You can rollback uncommitted Git changes safely because this Skill provides safety prompts before executing the state restoration. This prevents accidental data loss by warning you about uncommitted changes prior to the Git checkout.

What is the best way to re-sync context after a Git rollback?

The best way to re-sync context after a Git rollback is to read the IMPLEMENTATION_PLAN.md file from the restored state. This adjusts active task pointers and aligns the project context with the historical checkpoint.

When do I need a Git checkpoint recovery process?

You need a Git checkpoint recovery process when executing step-based progress resets, applying rollback scenarios, or re-syncing context after restoration. It allows precise restoration of the project state to a specific historical Git hash.