Back to Skills

handover

verified

Mid-session context dump for fresh sessions. Generates structured handover prompt with current state, saves to comms/handover.md for copy/paste into new session.

View on GitHub

Marketplace

space-agents

thebrownproject/space-agents

Plugin

space-agents

Repository

thebrownproject/space-agents

skills/handover/SKILL.md

Last Verified

January 22, 2026

Install Skill

Select agents to install to:

Scope:
npx add-skill https://github.com/thebrownproject/space-agents/blob/main/skills/handover/SKILL.md -a claude-code --skill handover

Installation paths:

Claude
.claude/skills/handover/
Powered by add-skill CLI

Instructions

# /handover - Context Dump for Fresh Session

Generate a structured handover prompt when context is filling up or you need to switch to a fresh session. The handover captures current state so the next session can continue seamlessly.

---

## Context

You are HOUSTON, the Flight Director. When context gets heavy or the user needs to switch sessions, `/handover` creates a portable context dump.

### When to Use

- Context window getting full (Claude will warn)
- Switching focus, need to preserve state
- Long-running session needs a fresh start
- Before ending for the day

### What Gets Captured

- Current voyage/mission/objective state
- Active alerts
- Recent decisions and context
- Git status (uncommitted changes)
- Session buffer contents

---

## Instructions

When the user runs `/handover`, execute these steps:

### Step 1: Query Current State

Run SQLite queries to gather state:

```sql
-- Active missions with progress
SELECT m.id, m.title, m.status,
       (SELECT COUNT(*) FROM objectives o
        WHERE o.mission_id = m.id AND o.status = 'complete') as done,
       (SELECT COUNT(*) FROM objectives o
        WHERE o.mission_id = m.id) as total
FROM missions m WHERE m.status IN ('staged', 'active');

-- In-progress objectives
SELECT o.id, o.title, o.description, m.title as mission
FROM objectives o
JOIN missions m ON o.mission_id = m.id
WHERE o.status = 'in_progress';

-- Active alerts
SELECT id, severity, mission_id, objective_id, source, description
FROM alerts WHERE status = 'active'
ORDER BY severity;
```

### Step 2: Check Git Status

Run `git status` and `git diff --stat` to capture:
- Uncommitted changes
- Current branch
- Files modified

### Step 3: Generate Handover Prompt

Create a structured prompt that the next session can use:

```markdown
# Space-Agents Handover

**Generated:** [YYYY-MM-DD HH:MM]
**From Session:** [session identifier if available]

---

## Current State

### Active Mission
- **ID:** MSN-XXX
- **Title:** [Mission title]
- **Status:

Validation Details

Front Matter
Required Fields
Valid Name Format
Valid Description
Has Sections
Allowed Tools
Instruction Length:
5520 chars