checkpoint-summary

Create a resumable checkpoint file with topic, state, and next steps.

2|Updated Feb 24, 2026
One-click install
npx skills add https://github.com/lestrrat/claude-code --skill checkpoint-summary
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: checkpoint-summary
Source: https://github.com/lestrrat/claude-code/tree/main/skills/checkpoint-summary
Command: npx skills add https://github.com/lestrrat/claude-code --skill checkpoint-summary

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Generate a resumable checkpoint file that another agent can read to resume work without replaying history, enabling reliable handoffs and continuity.

Core Features & Use Cases

  • Produces a structured checkpoint document containing topic, current state, decisions, files touched, commands run, and next steps.
  • Saves checkpoints under the project .tmp/checkpoints/ with a unique timestamp-id-topics slug filename to avoid overwrites.
  • Provides a simple CLI script at scripts/create-checkpoint.py to generate the checkpoint path and content for downstream automation.

Quick Start

Run ./scripts/create-checkpoint.py "<topic>" from the skill directory to create a new checkpoint.

Frequently Asked Questions about checkpoint-summary

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

FAQPage Schema
How do I create a resumable checkpoint for agent handoff?

To create a resumable checkpoint for agent handoff, run the create-checkpoint.py script with your topic. This generates a structured file under .tmp/checkpoints/ containing the current state, decisions, and next steps for another agent to resume work.

What is a checkpoint file used for in agent automation workflows?

A checkpoint file in agent automation workflows is used to save progress and hand off context without replaying history. It enables reliable continuity across sessions by storing the topic, current state, decisions, files touched, commands run, and next steps.

How do I save agent session state to continue work across multiple turns?

You save agent session state to continue work across multiple turns by generating a checkpoint file. The script creates a unique timestamp-id-topic slug filename under the .tmp/checkpoints/ directory to avoid overwrites and preserve the exact context needed to resume.

Can I use a CLI script to automate checkpoint generation for workflow handoffs?

Yes, you can use a CLI script to automate checkpoint generation for workflow handoffs. Running ./scripts/create-checkpoint.py with a topic argument automatically generates the checkpoint path and structured content for downstream automation.

What information is included in a resumable handoff checkpoint?

A resumable handoff checkpoint includes the topic, current state, decisions made, files touched, commands run, and next steps. This structured document provides the exact context another agent needs to resume the work without replaying previous history.

Does checkpoint generation require any external dependencies or tools?

Checkpoint generation does not require any external dependencies or tools. The Skill relies solely on the included scripts/create-checkpoint.py script to generate the checkpoint path and content within your project directory.