context-handoff

Generate a compact handoff document with redacted secrets and PII.

4|Updated Mar 21, 2026
One-click install
npx skills add https://github.com/leocosta/octopus --skill context-handoff-leocosta
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: context-handoff
Source: https://github.com/leocosta/octopus/tree/main/skills/context-handoff
Command: npx skills add https://github.com/leocosta/octopus --skill context-handoff-leocosta

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Compact the current conversation into a handoff document another agent can pick up — with a suggested-skills section, saved to the OS tmp dir (not the workspace), referencing existing PRDs/plans/ADRs/issues/commits by path rather than duplicating, with mandatory redaction of secrets and PII.

Core Features & Use Cases

  • Handoff generation: The handoff is prescriptive, telling the successor which skills to invoke, which files to read, and which decisions are already settled.
  • Redaction and privacy: Secrets and PII are mandatorily redacted to prevent leakage.
  • Reference-based context: Links to PRDs, plans, ADRs, issues, and commits by path instead of duplicating content.
  • OS temp storage: The handoff is saved to the system temporary directory, not the workspace.
  • Use Case: When a session ends and the next agent or model should continue work, generate a portable handoff and provide the path for retrieval.

Quick Start

Generate a handoff for the current conversation and save it to the OS temporary directory.

Frequently Asked Questions about context-handoff

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

FAQPage Schema
How do I preserve context when handing off a conversation to a different AI agent?

To preserve context for a different AI agent, generate a compact handoff document from the current conversation. This document references existing PRDs, plans, ADRs, issues, and commits by file path instead of duplicating content, ensuring seamless continuity.

How do I redact secrets and PII before transferring context to another model?

Redacting secrets and PII before transferring context is handled mandatorily during handoff document generation. The process automatically strips sensitive information to prevent leakage, ensuring the compact context file is safe to pass to the next model.

Can I generate a portable handoff document that tells the next AI which files to read?

Yes, you can generate a portable handoff document that prescribes the next steps for the successor agent. It explicitly tells the next AI which skills to invoke, which specific files to read, and which decisions are already settled.

Does the handoff document save to the workspace or a temporary directory?

The handoff document saves directly to the OS temporary directory, not the workspace. This prevents workspace clutter while providing a reliable file path for the next session or model to retrieve the compact context.

What is the best way to transfer conversation context between different AI models?

The best way to transfer conversation context between models is using a prescriptive handoff document. It compacts the current session, references existing plans by path, redacts sensitive data, and suggests which skills the successor model should invoke next.

When do I need a handoff document for my AI workflow?

You need a handoff document when a session ends and the next agent or model should continue the work. It compacts the conversation into a portable reference that guides the successor on settled decisions, required files, and next steps.