checkpoint

Creates git commits and Issue-comment state snapshots at pipeline phase boundaries.

Updated Aug 17, 2026
One-click install
npx skills add https://github.com/kai-kou/gem-hunter --skill checkpoint-kai-kou
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: checkpoint
Source: https://github.com/kai-kou/gem-hunter/tree/main/.claude/skills/checkpoint
Command: npx skills add https://github.com/kai-kou/gem-hunter --skill checkpoint-kai-kou

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Long-running multi-phase pipelines risk losing work when a session ends or fails mid-task. This Skill records restorable checkpoints at each phase boundary so work can resume safely after interruptions. ## Core Features & Use Cases - Git Commit Snapshots: Commits pending changes with a searchable checkpoint: message convention and pushes to the working branch. - Issue Comment State Records: Posts a structured checkpoint comment to the work Issue, including completed tasks, next steps, quality check status, and a machine-readable JSON status block for automatic reload in the next session. - Use Case: After finishing Step 3 of a build phase in a long pipeline, invoke the checkpoint to commit progress and log the next command to run, so a new session can pick up exactly where you left off. ## Quick Start Ask the AI to create a checkpoint recording the completion of the current pipeline phase step.

Frequently Asked Questions about checkpoint

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

FAQPage Schema
How do I save progress in a long-running AI pipeline?▼

Invoke the checkpoint at each phase boundary to commit pending changes with a searchable checkpoint message and post a state snapshot to the work Issue. The snapshot records completed tasks, next steps, and a JSON status block for resumption.

How to resume work after a session interruption in git workflows?▼

Search the target Issue's latest checkpoint comment for the JSON fenced block containing phase, next_steps, and updated_at fields. This machine-readable status tells the next session exactly which command to run to continue.

Can I create a checkpoint on the main branch?▼

No, checkpoints must not run on main or master branches because direct commits are prohibited. The skill verifies the current branch first and only proceeds on a working branch.

What happens if a checkpoint commit includes secrets?▼

A pre-commit secret detection gate blocks the commit if git add picks up .env files, keys, or tokens. Move the flagged files to .gitignore, run git rm --cached, then retry rather than disabling detection.

Does checkpoint create empty commits when nothing changed?▼

No, empty commits are skipped when git status is clean. In that case only the Issue comment snapshot is posted, recording state without polluting the commit history.