checkpoint
// Save current progress to memory-keeper to prevent work loss.
$ git log --oneline --stat
stars:194
forks:37
updated:March 4, 2026
SKILL.mdreadonly
SKILL.md Frontmatter
namecheckpoint
descriptionSave current progress to memory-keeper to prevent work loss.
Checkpoint Skill
Automatically checkpoint current progress to memory-keeper to prevent catastrophic work loss when context is exhausted.
When to Use
- Every 5-10 tool calls during implementation
- After completing a significant piece of work
- Before starting a large operation
- When switching tasks
- Before ending a session
- When explicitly requested via
/checkpoint
Checkpoint Actions
1. Gather Current State
Collect the following information:
- Current task description from todo list
- List of files modified this session
- Implementation progress (percentage or phase)
- Current blockers or issues
- Next action to take
2. Save to Memory-Keeper
context_save(key: "current-task", value: "<task description>", category: "progress", priority: "high")
context_save(key: "files-modified", value: "<comma-separated file list>", category: "progress")
context_save(key: "implementation-progress", value: "<percentage or phase>", category: "progress")
context_save(key: "next-action", value: "<exact next step>", category: "progress", priority: "high")
3. Create Named Checkpoint
context_checkpoint(
name: "checkpoint-<timestamp>",
description: "Task: <task>, Progress: <progress>, Files: <count>, Next: <action>"
)
4. Prepare for Compaction (if context is large)
context_prepare_compaction()
Checkpoint Frequency Guidelines
| Activity | Checkpoint Frequency |
|---|---|
| File creation/modification | After every file |
| Running tests | After each test run |
| Research/exploration | Every 10 tool calls |
| Debugging | After each hypothesis tested |
| Multi-step implementation | After each step |
Key Items to Always Save
| Key | Description | Priority |
|---|---|---|
current-task | What you're currently working on | high |
files-modified | All files touched this session | normal |
implementation-progress | How far along (%, phase) | normal |
next-action | Exact next step to take | high |
blockers | Current issues/blockers | high |
todo-state | Serialized todo list | normal |
Checkpoint Output
After checkpointing, confirm with:
Checkpoint saved:
- Task: <current task>
- Progress: <progress>
- Files modified: <count>
- Next action: <next step>
Recovery Reference
If context is lost, use /recover to restore state from checkpoints.