# Checkpoint

> Save current progress to memory-keeper to prevent work loss.

- Skill: `aiskillstore/checkpoint-2` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add aiskillstore/checkpoint-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/aiskillstore/checkpoint-2/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: aiskillstore (https://skillmd.com/u/aiskillstore)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/aiskillstore/checkpoint-2

---


# 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.