stark-handover

Persists session state as numbered handover chains and progress trackers for cross-session resumption.

Updated Mar 16, 2026
One-click install
npx skills add https://github.com/21StarkCom/stark-skills --skill stark-handover-21starkcom
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: stark-handover
Source: https://github.com/21StarkCom/stark-skills/tree/main/runtime-overrides/codex/skill/stark-handover
Command: npx skills add https://github.com/21StarkCom/stark-skills --skill stark-handover-21starkcom

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? When a coding session ends, context is cleared, or work spans multiple days, all the reasoning, decisions, and progress from the conversation are lost. This Skill captures that state into a structured, numbered handover chain plus a progress tracker so a fresh session can resume exactly where the previous one stopped, with no recap needed. ## Core Features & Use Cases - Save mode: Mines the conversation for goals, decisions, failed approaches, evidence, and next steps, then writes a handover_{N}.md file and rewrites a PROGRESS.md tracker via a CLI that owns paths, numbering, and frontmatter. - Resume mode: Loads the latest handover and tracker in one call, renders a short brief, rebuilds the task list, and starts on the next action immediately. - Status mode: Lists all tasks for the current project/worktree with latest sequence numbers and activity, so you can pick which task to resume. - Use Case: At the end of a day spent debugging an auth callback, invoke save to record what was tried and what remains; the next morning, invoke resume in a fresh session and continue without re-explaining anything. ## Quick Start Ask the assistant to save a handover of the current session before clearing context, then in a new session ask it to resume the task by name.

Frequently Asked Questions about stark-handover

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

FAQPage Schema
How do I save my Claude Code session progress before clearing context?▼

Invoke the handover skill in save mode before clearing context. It mines the conversation for goals, decisions, and next steps, then writes a numbered handover file and rewrites a progress tracker through its CLI so nothing is lost.

How do I resume work from a previous AI coding session?▼

Invoke the skill with resume, optionally passing a task slug. It loads the latest handover and progress tracker in one call, renders a short brief, rebuilds the task list, and starts on the next action immediately.

Where are handover files stored on disk?▼

Handovers are stored under a root directory defaulting to ~/Code/Handovers, organized by project, worktree, and task. The root can be changed via the handover.root config or the STARK_HANDOVER_ROOT environment variable.

Does session handover work outside a git repository?▼

Yes. When the working directory is not a git repository, handovers are stored under a path based on the current directory name with a no-git suffix, and all save, resume, and status commands still function.

What happens if resume finds no saved handover?▼

The CLI exits with code 2 and the skill reports that nothing is resumable. It then lists existing tasks for the project and asks what to work on, or you can simply start fresh work.