checkpoint

Save and resume working state across branches with Markdown frontmatter checkpoints.

Updated Feb 27, 2026
One-click install
npx skills add https://github.com/zhifengzhang-sz/divine-book --skill checkpoint-zhifengzhang-sz
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: checkpoint
Source: https://github.com/zhifengzhang-sz/divine-book/tree/main/.claude/skills/gstack/checkpoint
Command: npx skills add https://github.com/zhifengzhang-sz/divine-book --skill checkpoint-zhifengzhang-sz

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Save and resume your working state across branches by capturing git state, decisions made, and remaining work so you can pick up exactly where you left off. Proactively suggest checkpoints when a session ends, or when you switch context.

Core Features & Use Cases

  • Save checkpoints to capture current branch, modified files, and decisions.
  • Resume from a checkpoint to restore branch, status, and plan.
  • List existing checkpoints for quick review and project handoffs.

Quick Start

Run /checkpoint save to capture your current state and use /checkpoint resume to reload it.

Frequently Asked Questions about checkpoint

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

FAQPage Schema
How do I save and resume my git working state across branches?

To save and resume your git working state across branches, use the /checkpoint save command to capture your current branch, modified files, and decisions, then /checkpoint resume to restore that exact state later.

What is the best way to pause a Conductor workflow and pick it up later?

Pausing a Conductor workflow is done by running /checkpoint save, which records your current session status and remaining work into a deterministic Markdown frontmatter file under your project workspace for later resumption.

Does the checkpoint skill store modified files and decisions when switching tasks?

Yes, the checkpoint skill stores modified files and decisions when switching tasks by capturing your git branch, timestamp, status, and a summary into a Markdown file under the project workspace directory.

How do I list existing checkpoints for a project handoff?

You can list existing checkpoints for a project handoff by running the /checkpoint list command, which reviews all saved states containing branch details, timestamps, and work summaries stored in your workspace.

Can I use checkpoint to manage context switching without losing my git state?

Yes, you can use checkpoint to manage context switching without losing your git state by capturing your branch, modified files, and decisions before switching, then resuming from that checkpoint when you return.

Where are checkpoint files stored when saving a working session?

Checkpoint files are stored as Markdown frontmatter files in a deterministic path under the project workspace, such as ~/.gstack/projects/your-project/checkpoints, recording branch, timestamp, status, and summary.