resume-checkpoint — Claude Code skill for resuming work
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.
no license 132 installs ★ 3,042 updated 2026-10-23
npx skills add alexgreensh/token-optimizer --skill resume-checkpoint -a claude-codeWhat resume-checkpoint 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.
What it helps with
- 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 for the agent
- 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.
How to install resume-checkpoint
1Skills CLI (Vercel)
npx skills add alexgreensh/token-optimizer --skill resume-checkpoint -a claude-code2Manually: put the files in place
~/.claude/skills/resume-checkpoint/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/resume-checkpoint/
1Skills CLI (Vercel)
npx skills add alexgreensh/token-optimizer --skill resume-checkpoint -a codex2Manually: put the files in place
.agents/skills/resume-checkpoint/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add alexgreensh/token-optimizer --skill resume-checkpoint -a cursor2Manually: put the files in place
.cursor/skills/resume-checkpoint/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install alexgreensh/token-optimizer skills/resume-checkpoint2Manually: put the files in place
.github/skills/resume-checkpoint/SKILL.md1Skills CLI (Vercel)
npx skills add alexgreensh/token-optimizer --skill resume-checkpoint -a gemini-cli2Platform CLI
gemini skills install https://github.com/alexgreensh/token-optimizer --path skills/resume-checkpointManually: put the files in place
.devin/skills/resume-checkpoint/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add alexgreensh/token-optimizer --skill resume-checkpoint -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about resume-checkpoint
How do I install resume-checkpoint in Claude Code?
Run npx skills add alexgreensh/token-optimizer --skill resume-checkpoint -a claude-code. The skill file is at ~/.claude/skills/resume-checkpoint/SKILL.md.
What does resume-checkpoint do?
It ranks saved checkpoints against a continuation request and returns the best match as context. The recovered text is not treated as instructions.
What does resume-checkpoint need to run?
Token Optimizer must be installed, and python3 runs pull_checkpoint.py.