multi-agent-handoffs
Installation
SKILL.md
Multi-Agent Handoffs
A multi-agent handoff is the moment one agent finishes its job and passes output to the next agent. Research agent finds signals. Email agent writes the sequence. Scoring agent ranks the prospect. Each agent does one thing well. The handoff is where quality breaks or compounds.
The principle: every handoff is a contract. Agent A promises a specific output schema. Agent B expects that exact schema. If the contract breaks, the downstream agent hallucinates, guesses, or fails silently. Define the contract before building either agent.
The Handoff Contract
What a contract includes
| Element | What it defines | Example |
|---|---|---|
| Output schema | Exact fields Agent A must produce | { company_name: string, signal: string, signal_date: string, problem_hypothesis: string } |
| Required fields | Fields that must be non-null | company_name, signal are required. signal_date is optional |
| Field validation | Rules each field must satisfy | signal must be ≤ 50 words. signal_date must be within 90 days |
| Failure mode | What happens when a field is missing or invalid | Missing signal = skip prospect (don't pass to email agent) |
| Confidence score | Agent A's self-assessed confidence in the output | confidence: 0.0-1.0. Below 0.7 = flag for human review |