# Create a Clear Agent Handoff

Long conversations make session changes difficult and can expose sensitive details. This skill creates a concise, redacted handoff that references existing artifacts.

## Install

```bash
npx skillstore add mattpocock/handoff
```

## Metadata

- Status: approved
- Slug: mattpocock-handoff
- Skillstore revision: r2
- Version status: missing
- Tree hash: 592aec374ae07a247f4fd45d757c08197c04de8b18a54e25a88ef2c290479b4c
- Author: mattpocock
- GitHub username: mattpocock
- License: MIT
- Repository: https://github.com/mattpocock/skills/tree/main/skills/productivity/handoff/
- Ref: ebdfe608f5de2b66ff37ab4af12af8ac4f5e8006
- Supported tools: Claude, Codex, Claude Code
- Audit status: complete
- Agent install advisory: allowed
- Manual install advisory: allowed
- Artifact signature: available
- Audit attestation: unavailable
- Human verification: not\_verified
- Quality score: 75
- Public page: https://skillstore.pages.dev/skills/mattpocock-handoff
- Manifest: https://skillstore.pages.dev/api/skills/mattpocock-handoff/manifest

## Capabilities

- Summarizes the current conversation for a fresh agent.
- Tailors the handoff to the next session focus supplied by the user.
- Suggests relevant skills for the next agent to invoke.
- References existing artifacts by path or URL instead of duplicating their content.
- Directs the agent to redact secrets and personally identifiable information.
- Saves the handoff in the operating system temporary directory.

## Use Cases

- Continue Implementation: Prepare continuity notes before moving implementation work to a new AI session.
- Transfer Project Decisions: Summarize decisions and artifact references so another agent can continue a coordinated project.
- Redact Operational Context: Create a redacted transfer document when active context contains credentials or personal data.

## Prompt Templates

### Basic Handoff

```
Create a handoff for the next session.
```

### Focused Handoff

```
Create a handoff focused on completing the authentication tests. Reference existing plans and redact secrets.
```

### Artifact-Aware Handoff

```
Prepare a handoff for deployment work. Link relevant commits, issues, and ADRs without repeating their content.
```

### Investigation Handoff

```
Create a handoff for a fresh agent investigating the production regression. Prioritize verified evidence, unresolved questions, constraints, and suggested skills.
```

## Limitations

- The handoff only reflects context available in the current conversation.
- It does not validate referenced artifacts or confirm that the next agent can access them.
- Saving the document requires agent filesystem access outside the current workspace.
- It suggests skills but does not invoke them for the next agent.

## Best Practices

- Provide a clear focus argument when the next session has a specific objective.
- Keep durable decisions in existing artifacts and reference their paths or URLs.
- Review the generated handoff for sensitive data and missing context before sharing it.

## Anti Patterns

- Do not use the handoff as a substitute for project documentation.
- Do not include secrets, passwords, tokens, or unnecessary personal information.
- Do not assume the next agent can access local paths, private URLs, or uncommitted changes.

## Security Audit

- Audited at: 2026-07-23T18:58:51.98\+00:00
- Summary: The prompt contains no executable code, network requests, command execution, or injection. Saving conversation content outside the workspace creates low confidentiality risk despite required redaction.

## Stats

- Views: 26
- Downloads: 12
- Favorites: 0
- Popularity score: 0