CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

72

Quality

89%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

78%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-structured, lean overview that delegates templates to a clearly signaled one-level-deep reference and provides concrete troubleshooting guidance with validation gates. Main gaps are minor redundancy with the description and template-by-number references that require a file lookup to execute.

Suggestions

Trim or remove the 'When to Use This Skill' bullet list — it duplicates the frontmatter description's trigger scenarios and adds token cost without new information.

Inline a one-line summary of each named template next to its reference (e.g. 'Template 2: async TL;DR + watch list') so the troubleshooting guidance is actionable without opening references/details.md.

Move the outgoing/incoming checklist (currently in references/details.md) into the body or surface it at the end of the timing tree so the core workflow embeds its own validation gate.

DimensionReasoningScore

Conciseness

The body is mostly efficient — a compact components table, a small timing tree, and concrete troubleshooting with no explanation of concepts Claude already knows. Not a 5 because the 'When to Use This Skill' bullet list largely duplicates the description's trigger scenarios and could be trimmed.

4 / 5

Actionability

Gives concrete, specific guidance such as 'do not mark handoff complete until every section has at least one entry (or an explicit none)', 'Fall back to the async quick handoff template (Template 2)', and 'outgoing engineer fires a test alert and confirms incoming engineer receives it in PagerDuty and Slack'. Not a 5 because templates are referenced by number (Template 2, Template 3) without inline content, so the reader must open references/details.md to execute.

4 / 5

Workflow Clarity

The timing tree sequences the handoff with explicit time allocations, and troubleshooting adds validation gates (checklist gate, test-alert confirmation before ending overlap). Not a 5 because the core workflow section does not itself embed the validation checkpoints — they are scattered across troubleshooting — and the checklist lives in the reference file rather than the body.

4 / 5

Progressive Disclosure

SKILL.md is a concise overview and the full template library plus worked examples are split into a single one-level-deep reference, clearly signaled: 'Full template library and detailed worked examples live in references/details.md. Read that file when you need the concrete templates.' The referenced file exists, confirming the structure.

5 / 5

Total

17

/

20

Passed

Description

100%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong, comprehensive description that explicitly pairs a concrete capability statement with multiple natural trigger scenarios. Its only weakness is verbosity — the five 'when' clauses make it long, though each clause carries a distinct trigger rather than padding.

DimensionReasoningScore

Specificity

Names the domain plus multiple concrete actions — 'context transfer, escalation procedures, and documentation', 'writing a shift summary that captures active incidents, ongoing investigations, and recent changes', 'handing off mid-incident', 'onboarding', 'auditing' — giving comprehensive coverage. Not a 4 because the action list is broad and specific rather than having minor gaps.

5 / 5

Completeness

Explicitly answers 'what' ('Master on-call shift handoffs with context transfer, escalation procedures, and documentation') and 'when' via five concrete 'Use this skill when...' trigger clauses. Not a 4 because both what and when are present and concrete, matching the top anchor exactly.

5 / 5

Trigger Term Quality

Covers natural phrases users actually say — 'on-call shift handoffs', 'transitioning on-call responsibilities', 'shift summary', 'handing off mid-incident', 'onboarding a new engineer to the on-call rotation', 'auditing...handoff processes' — across several scenario variants. Not a 4 because the trigger phrasing is comprehensive rather than missing common variations.

5 / 5

Distinctiveness Conflict Risk

Occupies a clear niche (on-call shift handoffs) with distinct triggers that are unlikely to fire for adjacent skills like incident-classification or postmortem-facilitation. Not a 4 because the handoff-specific triggers create minimal overlap risk with related skills.

5 / 5

Total

20

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 2 suspicious

Warning

Total

15

/

16

Passed

Repository
wshobson/agents
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.