# resume-checkpoint

The resume-checkpoint Claude Code skill retrieves context from an earlier session. It runs when a task continues and the agent needs to recover what was being worked on.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 132 installs · ★ 3042 repo stars
- Author: alexgreensh
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/alexgreensh/token-optimizer/tree/HEAD/skills/resume-checkpoint/SKILL.md
- Updated: 2026-10-23
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/resume-checkpoint

## What it does

The skill matches the continuation request against saved checkpoints and returns the strongest match. Its contents are fenced as recovered context, not instructions for the agent to follow.

It runs `pull_checkpoint.py` with `python3`; the script takes the user's request and can also receive the current directory and session ID. Each call costs about 300 tokens. Token Optimizer must be installed for the script to be found.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add alexgreensh/token-optimizer --skill resume-checkpoint -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/resume-checkpoint/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/resume-checkpoint/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add alexgreensh/token-optimizer --skill resume-checkpoint -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/resume-checkpoint/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add alexgreensh/token-optimizer --skill resume-checkpoint -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/resume-checkpoint/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install alexgreensh/token-optimizer skills/resume-checkpoint
```

2. **Manually: put the files in place**
- File: `.github/skills/resume-checkpoint/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add alexgreensh/token-optimizer --skill resume-checkpoint -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/alexgreensh/token-optimizer --path skills/resume-checkpoint
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/resume-checkpoint/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add alexgreensh/token-optimizer --skill resume-checkpoint -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/alexgreensh/token-optimizer/tree/HEAD/skills/resume-checkpoint/SKILL.md

## When to use it
- recover context from an earlier task
- find a checkpoint related to a continuation request
- keep instructions from a previous session separate from current context

## Example prompts
- Resume the previous task and recover its context.
- What were we working on in the last session?
- Pick up the earlier work on this topic.

## Similar
- [checkpoint](https://affpapa.org/en/nevibecode/skills/checkpoint.md) — skill · 4000 installs
- [checkpoint-promotion](https://affpapa.org/en/nevibecode/skills/checkpoint-promotion.md) — skill · 2600 installs
- [war-room-checkpoint](https://affpapa.org/en/nevibecode/skills/war-room-checkpoint.md) — skill · 2 installs
- [promote-checkpoint](https://affpapa.org/en/nevibecode/commands/promote-checkpoint.md) — command · ★ 42780 repo stars
- [shadcn-status-checkpoint](https://affpapa.org/en/nevibecode/commands/shadcn-status-checkpoint.md) — command · ★ 267 repo stars
- [resume-bullet-writer](https://affpapa.org/en/nevibecode/skills/resume-bullet-writer.md) — skill · 13800 installs

From the same set: [alexgreensh/token-optimizer](https://affpapa.org/en/nevibecode/by/alexgreensh/token-optimizer.md) — 5 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
