capability-checkpoint

Writes and resumes per-story progress checkpoints so work survives context resets.

Updated Mar 31, 2026
One-click install
npx skills add https://github.com/learnn-com/engineering-kb --skill capability-checkpoint-learnn-com
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: capability-checkpoint
Source: https://github.com/learnn-com/engineering-kb/tree/main/.skills/capability-checkpoint
Command: npx skills add https://github.com/learnn-com/engineering-kb --skill capability-checkpoint-learnn-com

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Long-running development stories lose their state when an AI session hits a context limit or a subagent takes over, forcing expensive re-derivation of what was done, decided, and left to do. This Skill persists a structured, self-contained checkpoint per story and restores it on demand. ## Core Features & Use Cases - Write mode: Captures story ID, branch, tasks done, key decisions, and remaining todos into a single file at .pair/working/checkpoints/<story-id>.md, updated in place and never duplicated. - Resume mode: Locates and parses the existing checkpoint for a story, reporting parsed state with explicit gap markers instead of guessing when sections are missing. - Write-free composition: With $persist=false, returns the rendered checkpoint text without touching the filesystem so composers like /capability-publish-pr can embed it in a PR body. - Use Case: Mid-story on issue #313 with 2 of 5 tasks done, invoke the skill to save progress; after a context reset, resume and jump straight to the next pending task without re-analyzing the branch. ## Quick Start Ask the assistant to save our progress on story #313, or to resume story #256 from its checkpoint.

Frequently Asked Questions about capability-checkpoint

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

FAQPage Schema
How do I save progress so an AI session can resume after a context reset?▼

Invoke the skill in write mode with the story ID, for example 'save our progress on #313'. It renders a five-section checkpoint (story, branch, tasks done, decisions, remaining todos) and writes it to .pair/working/checkpoints/<story-id>.md.

How do I resume work on an interrupted story from a checkpoint?▼

Invoke the skill with $mode=resume and the story ID. It locates the checkpoint file, parses the five sections, and reports tasks done, tasks left, and decisions so the next pending task is immediately identifiable.

What happens if no checkpoint exists for a story on resume?▼

Resume mode halts with a clear message that no checkpoint was found for the story. You can either start fresh or provide checkpoint text directly instead of reconstructing state.

Can I generate a checkpoint without writing a file to disk?▼

Yes, pass $persist=false in write mode. The skill synthesizes and returns the full checkpoint text without touching the filesystem, which suits composers that embed the handoff in a PR body.

What happens when the checkpoint file is corrupted or incomplete?▼

Resume mode reports exactly what was parsed, lists missing or ambiguous sections, and asks for confirmation before proceeding. It never fills gaps by guessing; unresolvable fields are marked as needing confirmation.