checkpoint

Writes durable end-of-session checkpoints to a session log and syncs open TODOs.

3|Updated Oct 28, 2020
One-click install
npx skills add https://github.com/k0d3x8its/dotfiles --skill checkpoint-k0d3x8its
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: checkpoint
Source: https://github.com/k0d3x8its/dotfiles/tree/main/claude/.claude/skills/session-checkpoint
Command: npx skills add https://github.com/k0d3x8its/dotfiles --skill checkpoint-k0d3x8its

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It prevents loss of context between long AI-assisted work sessions by durably recording decisions, completed work, and gotchas so the next session resumes without re-litigating prior choices. ## Core Features & Use Cases - Narrative Session Logging: Appends a structured checkpoint block (goal, completed items, decisions, files touched, gotchas) to .memory/SESSION-LOG.md. - TODO Synchronization: Updates TODOS.md in-place, removing completed items and appending new tagged open items, supporting both flat and .work/plan/ formats. - Knowledge Promotion & Triage Refresh: Proposes eligible facts for local or global KNOWLEDGE.md and runs idempotent cache, log-rotation, and triage-pipeline commands. - Use Case: At the end of a multi-hour coding session, run /checkpoint to capture why decisions were made, then /clear and paste the printed re-entry prompt to start the next session with full context. ## Quick Start Ask the AI to run /checkpoint at the end of your work session to write the session log, sync TODOS.md, and print a re-entry prompt.

Frequently Asked Questions about checkpoint

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

FAQPage Schema
How do I save context at the end of a Claude Code session?▼

Run /checkpoint to append a structured narrative block to .memory/SESSION-LOG.md, sync TODOS.md, and print a re-entry prompt. Then run /clear manually and paste the re-entry prompt as the first message of the next session.

What is the difference between /checkpoint and /handoff?▼

Use /checkpoint for durable end-of-day or end-of-session closure when real decisions were made; it costs about 2K tokens. Use /handoff for cheap mid-session tangent forks at roughly 400 tokens, and /handoff-return to merge tangent findings back.

Does the checkpoint skill work without a TODOS.md file?▼

Yes. If TODOS.md does not exist, the skill creates it with a standard header and migrates every unchecked item from prior Incomplete / Next Steps blocks in SESSION-LOG.md, deduplicated, as a one-time migration.

When should I not use a session checkpoint?▼

Avoid it for quick mid-session forks or tangents that do not need durable narrative; use /handoff instead. Checkpoint is the heavy option meant for end of day or sessions where significant decisions were made.

Why does the checkpoint skill mention cache TTL?▼

Claude Code caches tokens for about one hour, and cached tokens cost roughly 10 percent of normal input price. Running /checkpoint then /clear at session end avoids paying full price to rebuild expired context.