checkpoint

Generate a structured session checkpoint with completed tasks, blockers, and file diffs.

1|Updated Jan 27, 2026
One-click install
npx skills add https://github.com/Joaovsales/coding-agent-workflow --skill checkpoint-joaovsales
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: checkpoint
Source: https://github.com/Joaovsales/coding-agent-workflow/tree/main/.agents/skills/checkpoint
Command: npx skills add https://github.com/Joaovsales/coding-agent-workflow --skill checkpoint-joaovsales

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Captures and preserves the current session state by writing a structured checkpoint to tasks/checkpoint.md, enabling smooth handoffs and pause/resume without losing context.

Core Features & Use Cases

  • Snapshot current work state by aggregating git status, diffs, and recent commits.
  • Generate a structured checkpoint with sections for Overall Status, Completed This Session, Remaining Tasks, Open Questions / Blockers, and Files Modified.
  • Use case: before handing off a coding task or pausing work, create a checkpoint that teammates can resume from with minimal context.

Quick Start

Use this skill to snapshot the current session progress to tasks/checkpoint.md for handoff or pause.

Frequently Asked Questions about checkpoint

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

FAQPage Schema
How do I snapshot my coding session progress for a handoff?

You snapshot coding session progress by generating a structured checkpoint that aggregates git status, diffs, and recent commits. This creates a concise file capturing completed tasks, remaining work, and blockers for teammates to resume seamlessly.

What is the best way to document remaining tasks and blockers before pausing work?

Documenting remaining tasks and blockers before pausing work involves writing a structured checkpoint file. It enforces a consistent format to capture overall status, open questions, and modified files, ensuring no context is lost during pause and resume cycles.

Does this checkpoint workflow require a specific todo file format?

This checkpoint workflow reads from a tasks/todo.md file to identify remaining items. It requires this markdown format to extract current task state and write the resulting structured progress snapshot to tasks/checkpoint.md.

Can I automatically commit my session checkpoint via git?

You can automatically commit your session checkpoint via git. The snapshot process optionally integrates with git to commit the generated checkpoint file, preserving the handoff-ready context directly in your repository history.

What sections are included in a generated session checkpoint?

A generated session checkpoint includes sections for Overall Status, Completed This Session, Remaining Tasks, Open Questions or Blockers, and Files Modified. This structured format ensures all critical handoff context is consistently documented.