Enables saving snapshots of work before risky changes, allowing for precise rollback if needed.

Install

mkdir -p .claude/skills/checkpoint-darkroomengineering && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/18769" && unzip -o skill.zip -d .claude/skills/checkpoint-darkroomengineering && rm skill.zip

Installs to .claude/skills/checkpoint-darkroomengineering

Activation

This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.

Mid-task rollback points — save/restore state before risky ops (refactors, migrations, destructive edits). For end-of-session save use `/handoff`. Triggers "checkpoint", "snapshot", "before this risky op", "rollback to", "list checkpoints", pre-refactor save.
259 charsno explicit “when” triggerlonger than Claude Code's old 250-char listing cap (fine on current versions)
Intermediate

Key capabilities

  • →Save current state with an optional label
  • →List all checkpoints for the current project
  • →Show details of a specific checkpoint
  • →Restore tracked files to a previous state
  • →Remove old checkpoints, keeping the last 10

How it works

The skill saves the current project state, including tracked files and uncommitted changes, as a checkpoint. It can then restore this state, reapplying uncommitted changes as a patch.

Inputs & outputs

You give it
current project state
You get back
saved checkpoint or restored project files

When to use checkpoint

  • →Saving state before refactoring
  • →Rolling back after a failed change
  • →Managing task milestones

About checkpoint

Provides commands to save, list, and restore the state of the current project, acting as mid-task rollback points.

Mid-task rollback points — save/restore state before risky ops (refactors, migrations, destructive edits). For end-of-session save use `/handoff`. Triggers "checkpoint", "snapshot", "before this risky op", "rollback to", "list checkpoints", pre-refactor save.

When not to use it

  • →For end-of-session saves
  • →When untracked files need to be restored or deleted
  • →When the current branch or HEAD differs from the checkpoint and `--force` is not desired

Limitations

  • →Untracked files are never touched or deleted during restore
  • →Index state is intentionally not reconstructed during restore
  • →Restore refuses if the current branch or HEAD differs from the checkpoint unless `--force` is used

How it compares

This skill provides mid-task rollback points by saving and restoring project state, including uncommitted changes, unlike standard version control commits which only track committed changes.

Compared to similar skills

checkpoint side by side with the closest alternatives in the catalog.

SkillInstallsUpdatedSafetyDifficulty
checkpoint (this skill)03moReviewIntermediate
grepai49moReviewBeginner
resolve04moNo flagsIntermediate
time-travel08moReviewIntermediate

Try saying

Example prompts that trigger this skill in your AI assistant.

Search skills

Search the agent skills registry