handoff-context

Automates rewriting CONTEXT.md with goal, progress, blockers, and git state for handoffs.

Updated Jun 7, 2026
One-click install
npx skills add https://github.com/schneidermu/agent-dotfiles --skill handoff-context
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: handoff-context
Source: https://github.com/schneidermu/agent-dotfiles/tree/main/codex-skills/handoff-context
Command: npx skills add https://github.com/schneidermu/agent-dotfiles --skill handoff-context

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates updating CONTEXT.md at the project root with the current goal, progress, blockers, and next steps to enable seamless handoff between devices and tools.

Core Features & Use Cases

  • Create or rewrite a structured CONTEXT.md containing last updated, current goal, progress with in-progress marker, blockers, and next actions.
  • Validate project root existence, read recent git state, and preserve important decisions for the next session.
  • Support follow-on sessions across Cursor, Codex, or Claude Code by providing a ready-to-pick-up context.

Quick Start

Instruct the AI to rewrite CONTEXT.md with the latest session summary following the specified format.

Frequently Asked Questions about handoff-context

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

FAQPage Schema
How do I save project context for handoff to another AI coding tool?

To save project context for handoff, update a CONTEXT.md file at the project root with the current goal, progress, blockers, and next steps. This allows another AI coding tool to read the file and immediately resume the work session.

What is the best way to document git state and progress before switching devices?

The best way to document progress before switching devices is to generate a structured CONTEXT.md file. It records recent git state, touched files, and current blockers, ensuring the next session starts with a ready-to-pick-up software development context.

How do I create a session summary for Cursor or Claude Code to pick up?

You create a session summary for Cursor or Claude Code by instructing your current AI to rewrite CONTEXT.md. It will validate the project root, extract the latest git state, and write a concise summary of in-progress tasks and next actions.

Do I need a specific framework to maintain context across AI coding sessions?

No specific framework is needed to maintain context across AI coding sessions. You only need a project root directory and git state, which the context handoff process reads to generate a standardized CONTEXT.md file for the next agent.

What information should a CONTEXT.md file include for cross-tool handoffs?

A CONTEXT.md file for cross-tool handoffs should include the last updated date, current goal, progress with in-progress markers, blockers, and next actions. It also records metadata like the tool used to ensure seamless coordination.

Can I use CONTEXT.md to coordinate software development between multiple agents?

Yes, you can use CONTEXT.md to coordinate software development between multiple agents. It enforces a standardized format that captures recent git state and touched files, providing reliable project management context for any follow-on agent.