# On Call Handoff Patterns

> Master on-call shift handoffs with context transfer, escalation procedures, and documentation. Use this skill when transitioning on-call responsibilities between engineers and ensuring the incoming responder has full situational awareness, when writing a shift summary that captures active incidents, ongoing investigations, and recent changes, when handing off mid-incident so a fresh engineer can take over the incident commander role without losing context, when onboarding a new engineer to the on-call rotation for the first time, or when auditing and improving the quality of existing handoff processes across teams.

Source: https://skillsagentes.com/skills/wshobson/agents/on-call-handoff-patterns
Repository: https://github.com/wshobson/agents
Author: wshobson
License: MIT
Updated: hace 2 meses
Context cost: 156 tok installed, 937 tok once triggered, 2.5k tok with every bundled file
Bundle: 2 files, 10 KB
Permissions requested: none declared

## Install

```bash
npx -y skills add wshobson/agents --skill on-call-handoff-patterns --agent claude-code
```

## What it does

- Proporciona plantillas y estructura para documentos de handoff de guardia (incidentes activos, investigaciones, cambios recientes)
- Define la mecánica de tiempo para la transición entre turnos (overlap de 30 min)
- Ofrece soluciones de troubleshooting para handoffs incompletos, remotos o en medio de un incidente

## Use it when

- Transicionar responsabilidades de guardia entre ingenieros
- Escribir un resumen de turno que capture incidentes activos e investigaciones
- Hacer handoff en medio de un incidente para transferir el rol de incident commander
- Incorporar a un nuevo ingeniero a la rotación de guardia por primera vez

## What triggers it

- "Ayúdame a escribir el resumen de handoff para el próximo turno de guardia"
- "Necesito transferir el rol de incident commander a otro ingeniero"
- "¿Cómo estructuro el onboarding de un nuevo ingeniero a la rotación on-call?"

## Before you install

- Consultar references/details.md para las plantillas completas y ejemplos detallados.

## Files

- SKILL.md — 4 KB
- references/details.md — 6 KB

## SKILL.md

Reproduced verbatim from wshobson/agents under MIT. This section is the upstream document and is in English.

# On-Call Handoff Patterns

Effective patterns for on-call shift transitions, ensuring continuity, context transfer, and reliable incident response across shifts.

## When to Use This Skill

- Transitioning on-call responsibilities
- Writing shift handoff summaries
- Documenting ongoing investigations
- Establishing on-call rotation procedures
- Improving handoff quality
- Onboarding new on-call engineers

## Core Concepts

### 1. Handoff Components

| Component                  | Purpose                 |
| -------------------------- | ----------------------- |
| **Active Incidents**       | What's currently broken |
| **Ongoing Investigations** | Issues being debugged   |
| **Recent Changes**         | Deployments, configs    |
| **Known Issues**           | Workarounds in place    |
| **Upcoming Events**        | Maintenance, releases   |

### 2. Handoff Timing

```
Recommended: 30 min overlap between shifts

Outgoing:
├── 15 min: Write handoff document
└── 15 min: Sync call with incoming

Incoming:
├── 15 min: Review handoff document
├── 15 min: Sync call with outgoing
└── 5 min: Verify alerting setup
```

## Templates and detailed worked examples

Full template library and detailed worked examples live in `references/details.md`. Read that file when you need the concrete templates.

## Troubleshooting

**Incoming engineer misses a critical issue because the handoff document was incomplete.**
Use the outgoing checklist as a gate: do not mark handoff complete until every section has at least one entry (or an explicit "none"). Make incomplete handoffs a blameless postmortem action item.

**A 30-minute sync call is not possible due to timezone gaps.**
Fall back to the async quick handoff template (Template 2). Supplement with a short Loom or voice memo walking through the watch list. Ensure the incoming engineer has a direct contact method if they have follow-up questions.

**The incoming engineer inherits a mid-incident and is immediately overwhelmed.**
Use the incident handoff template (Template 3) specifically. The outgoing engineer should remain available on Slack for 15 minutes after handoff, even if off-call, to answer clarifying questions.

**On-call handoff documents are inconsistently formatted across teams.**
Adopt the shift handoff template organization-wide and store completed handoffs in a shared location (wiki, Notion, Confluence). Link each handoff from the on-call schedule entry in PagerDuty.

**Incoming engineer cannot verify their alerting is working before the outgoing engineer logs off.**
Add a standard step: outgoing engineer fires a test alert and confirms incoming engineer receives it in PagerDuty and Slack before ending the overlap window.

## Related Skills

- [incident-classification](../../skills/incident-classification/SKILL.md) — Classify and prioritize incidents that need to be included in the handoff document
- [postmortem-facilitation](../../skills/postmortem-facilitation/SKILL.md) — Turn resolved incidents from the shift into structured postmortems

---

Skills Agentes — https://skillsagentes.com/skills/wshobson/agents/on-call-handoff-patterns