catchup

Verify handoff documents against git status and recent commits.

24|6|Updated Mar 6, 2026
One-click install
npx skills add https://github.com/tobyilee/toby-plugins --skill catchup-tobyilee
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: catchup
Source: https://github.com/tobyilee/toby-plugins/tree/main/plugins/toby-session/skills/catchup
Command: npx skills add https://github.com/tobyilee/toby-plugins --skill catchup-tobyilee

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps operators start a Claude Code session by verifying and reconciling the handoff document with the current repository state. It treats the handoff as a hypothesis and ensures content matches live files, git status, and recent commits before any action.

Core Features & Use Cases

  • Locate the latest handoff and determine its age to assess staleness.
  • Read the handoff and project state in parallel (git status, git log, uncommitted changes) to produce a verification report.
  • Verify each referenced file against current content and classify as Confirmed, Shifted, Missing, or Ambiguous; cross-check with git to reconcile open work and new commits.

Quick Start

Start a new Claude Code session and run catchup to align with the latest handoff and verify its claims against the current repository.

Frequently Asked Questions about catchup

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

FAQPage Schema
How do I verify a project handoff document against the current git status?

Run catchup at the start of a Claude Code session to verify the handoff document in parallel with git status, git log, and uncommitted changes, classifying referenced files as Confirmed, Shifted, Missing, or Ambiguous.

What is handoff verification in an AI-assisted code workflow?

Handoff verification in an AI-assisted code workflow treats the handoff document as a hypothesis, checking its claims against live files, git status, and recent commits to detect drift, missing files, or updated content before taking any action.

How do I detect drift between a handoff document and recent git commits?

To detect drift between a handoff document and recent git commits, catchup cross-checks referenced files against current content and recent commit history, reporting discrepancies with clear classifications ready for user instruction.

Can I use this handoff verification skill without any external dependencies?

You can use this handoff verification skill without external dependencies, as it relies solely on your existing repository state and git history to reconcile the handoff document with current project files.

What is the best way to start a Claude Code session using a stale handoff?

The best way to start a Claude Code session using a stale handoff is to run catchup, which locates the latest handoff, determines its age to assess staleness, and verifies its claims against current repository state before proceeding.

When should I not rely on a project handoff document before acting?

You should not rely on a project handoff document before acting when it has not been verified against live files and git status, as catchup treats the handoff as a hypothesis that must be reconciled to detect missing files or updated content.