handoff

Generates a verified, copy-pasteable session-handoff prompt from think-and-ship state and current code.

1|Updated Aug 15, 2026
One-click install
npx skills add https://github.com/AlrikOlson/think-and-ship --skill handoff-alrikolson
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: handoff
Source: https://github.com/AlrikOlson/think-and-ship/tree/main/crates/think-and-ship/skills/handoff
Command: npx skills add https://github.com/AlrikOlson/think-and-ship --skill handoff-alrikolson

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When a long AI coding session ends or compacts, the reasoning and context die with the conversation, forcing the next session to re-derive decisions or follow stale leads. This Skill packages the current project state into a dense, verified prompt the next session can paste to resume work with zero re-learning. ## Core Features & Use Cases - Source-of-truth grounding: Reads think-and-ship state (roadmap_status, roadmap_next, ship_status, signal_pending) plus the current code to determine what is actually true now, not what the trace once claimed. - Ruthless trace filtering: Mines the think trace for the 'why' and hard-won gotchas while excluding superseded decisions, abandoned branches, and stale next_actions. - Fact verification: Confirms every load-bearing fact (files, recipes, gate commands) against the current code before carrying it forward, labeling anything unverifiable. - Use Case: At the end of a long refactoring session, run /handoff to produce a single fenced prompt naming the exact next roadmap chunk, proven templates to clone, verified gotchas, real gate commands, and honest open items for the next session. ## Quick Start Ask the AI to write a handoff for the next session using the current think-and-ship roadmap and ship state.

Frequently Asked Questions about handoff

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

FAQPage Schema
How do I hand off an AI coding session to the next session?▼

Run the handoff skill to produce one fenced prompt containing the exact next roadmap chunk, the run's objective, verified templates to clone, gotchas, real gate commands, and honest open items. The next session pastes that prompt to start with full context.

What is a session handoff prompt for AI agents?▼

It is a dense, next-action-scoped prompt written for the next agent session, grounded in roadmap and ship state plus current code. It carries forward only verified, relevant facts and excludes stale or superseded trace entries.

Does the handoff skill work without think-and-ship installed?▼

Yes, it degrades gracefully. Without the think-and-ship MCP server, it builds the handoff from git log, the current code, and any ROADMAP or TODO documents, and states that it did so.

Why not just dump the full think trace into the handoff?▼

The trace is append-only and full of superseded decisions, abandoned branches, and stale next_actions. Dumping it poisons the handoff, so the skill filters aggressively and verifies each load-bearing fact against current code before carrying it forward.

Can the handoff skill also do the remaining work or update the roadmap?▼

No. It only reads think-and-ship state and code and writes the handoff prompt. It performs no roadmap or ship mutations, no commits, and no code edits; do the work first under the appropriate skill, then run the handoff.