
handoff-protocols
Designing smooth transitions between agents and between AI and humans.
- Installs
- 144
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/owl-listener/ai-design-skills --skill handoff-protocols- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads handoff-protocols automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
Handoff Protocols
A handoff is the moment one agent passes work to another — or to a human. It's where multi-agent systems most commonly fail. A dropped handoff means lost context, repeated work, or abandoned tasks.
Anatomy of a Handoff
Every handoff has:
- Trigger: What causes the handoff? (task completion, scope boundary, failure, user request)
- Source: Who is handing off?
- Destination: Who is receiving?
- Payload: What information transfers? (context, partial results, user state, instructions)
- Acknowledgment: How does the source know the destination received the handoff?
- User experience: What does the user see during the handoff?
Handoff Types
- Sequential: Agent A finishes, passes results to Agent B who continues. Like a relay race.
- Parallel fan-out: One agent distributes subtasks to multiple agents simultaneously.
- Parallel fan-in: Multiple agents' results converge back to one agent for synthesis.
- Escalation: An agent can't handle the task and passes up to a more capable agent or human.
- Fallback: The primary agent fails and a backup takes over.
- Human handoff: AI passes work to a human for review, decision, or completion.
Context Transfer
The most common handoff failure is context loss. Design what transfers:
- Full context: Everything the source agent knew. Safe but potentially overwhelming.
- Summarised context: Key information distilled. Efficient but risks losing important nuance.
- Structured context: Predefined fields that must be populated. Consistent but rigid.
- Incremental context: Only what's new since the last handoff. Efficient for ongoing collaborations.
Designing for the User
The user's experience of handoffs matters:
- Invisible handoff: The user doesn't know agents changed. The experience feels seamless.
- Transparent handoff: The user is told a new agent is taking over and why.
- Participatory handoff: The user confirms the handoff or provides additional context.
- User-initiated handoff: The user explicitly requests a different agent or a human.
Handoff Anti-Patterns
- The black hole: Work is handed off but never picked up
- The echo chamber: Agents hand work back and forth without progress
- The context cliff: Critical information is lost in the handoff
- The jarring transition: The user's experience changes dramatically at the handoff point
- The silent redirect: The user doesn't know they've been handed off and gets confused by changes
Design Artefacts
- Handoff protocol specifications (trigger, source, destination, payload, acknowledgment)
- Context transfer templates
- Handoff sequence diagrams
- User experience specifications for each handoff type
- Handoff failure mode analysis
FAQ
What does the handoff-protocols skill do?
Designing smooth transitions between agents and between AI and humans.
How do I install handoff-protocols?
Run npx skills add https://github.com/owl-listener/ai-design-skills --skill handoff-protocols in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/handoff-protocols/ (personal) or .claude/skills/handoff-protocols/ (project).
Which AI agents can use handoff-protocols?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is handoff-protocols safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains handoff-protocols?
It is published by owl-listener in owl-listener/ai-design-skills. It has 144 recorded installs.
More from owl-listener/ai-design-skills
system-prompt-structure
owl-listener/ai-design-skills
Open the skill to read its SKILL.md instructions.
guardrail-design
owl-listener/ai-design-skills
Open the skill to read its SKILL.md instructions.
constraint-specification
owl-listener/ai-design-skills
Defining output format, length, tone, and content boundaries within prompts.
generative-ui
owl-listener/ai-design-skills
Designing interfaces where AI generates UI components dynamically.
conversation-patterns
owl-listener/ai-design-skills
Turn-taking, repair sequences, grounding, and dialogue structure for human-AI interaction.
progressive-disclosure
owl-listener/ai-design-skills
Open the skill to read its SKILL.md instructions.
Popular code quality & workflow skills
grill-me
mattpocock/skills
A relentless interview to sharpen a plan or design.
improve-codebase-architecture
mattpocock/skills
Scan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.
handoff
mattpocock/skills
Compact the current conversation into a handoff document for another agent to pick up.
domain-modeling
mattpocock/skills
Build and sharpen a project's domain model. Use when discussing codebase terminology, writing or editing a GLOSSARY.md, or recording or editing an ADR.
codebase-design
mattpocock/skills
Shared vocabulary for designing deep modules. Use when the user wants to design or improve a module's interface, find deepening opportunities, decide where a seam goes, make code more testable or AI-navigable, or when another skill needs the deep-module vocabulary.
diagnosing-bugs
mattpocock/skills
Diagnosis loop for hard bugs and performance regressions. Use when the user says "diagnose"/"debug this", or reports something broken/throwing/failing/slow.