Master on-call shift handoffs with context transfer, escalation procedures, and documentation. Use when transitioning on-call responsibilities, documenting shift summaries, or improving on-call processes.
72
58%
Does it follow best practices?
Impact
95%
1.53xAverage score across 3 eval scenarios
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./tests/ext_conformance/artifacts/agents-wshobson/incident-response/skills/on-call-handoff-patterns/SKILL.mdQuality
Discovery
89%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a solid skill description with clear 'what' and 'when' clauses and good trigger term coverage for the on-call handoff domain. Its main weakness is that the capability descriptions lean slightly toward category labels rather than concrete, granular actions. The use of 'Master' as the opening verb is slightly informal but acceptable; the description is otherwise well-structured and distinctive.
Suggestions
Replace category-level terms like 'context transfer' and 'escalation procedures' with more concrete actions, e.g., 'generate handoff notes summarizing active incidents, create escalation checklists, document shift timelines and outstanding action items.'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (on-call shift handoffs) and mentions some actions like 'context transfer, escalation procedures, and documentation,' but these are more like categories than concrete specific actions. It doesn't list granular tasks like 'generate handoff notes, create escalation checklists, summarize incident timelines.' | 2 / 3 |
Completeness | Clearly answers both 'what' (master on-call shift handoffs with context transfer, escalation procedures, and documentation) and 'when' (use when transitioning on-call responsibilities, documenting shift summaries, or improving on-call processes) with an explicit 'Use when...' clause. | 3 / 3 |
Trigger Term Quality | Includes natural keywords users would say: 'on-call,' 'shift handoffs,' 'context transfer,' 'escalation procedures,' 'shift summaries,' and 'on-call processes.' These cover a good range of terms someone transitioning on-call duties would naturally use. | 3 / 3 |
Distinctiveness Conflict Risk | On-call shift handoffs is a very specific niche that is unlikely to conflict with other skills. The triggers are distinct and narrowly scoped to on-call operations, making it clearly distinguishable from general documentation or incident management skills. | 3 / 3 |
Total | 11 / 12 Passed |
Implementation
27%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill is a comprehensive but excessively verbose collection of on-call handoff templates and checklists. While the templates themselves are well-structured and realistic, the skill suffers from being a monolithic document that explains many concepts Claude already understands. The content would benefit greatly from being split into separate template files with a lean overview, and from removing generic advice in favor of specific, actionable instructions for generating handoff documents.
Suggestions
Split the three templates into separate referenced files (e.g., SHIFT_HANDOFF.md, QUICK_HANDOFF.md, INCIDENT_HANDOFF.md) and keep SKILL.md as a concise overview with clear navigation links.
Remove generic best practices (Do's/Don'ts, 'Document everything', 'Take breaks') that Claude already knows, and replace with specific decision criteria or thresholds unique to this workflow.
Add validation steps: e.g., 'After writing the handoff, verify it covers all 5 components from the table' or 'Confirm incoming engineer has acknowledged receipt before ending shift'.
Reduce template placeholder data to minimal examples - one investigation entry instead of two, fewer rows in tables - since Claude can extrapolate the pattern from a single example.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Extremely verbose at ~350+ lines. Much of the content is generic on-call advice that Claude already knows (e.g., 'Document everything', 'Escalate early', 'Take breaks'). The templates contain extensive placeholder data that inflates token count significantly. The 'Core Concepts' table explains obvious things like 'Active Incidents = What's currently broken'. Best practices do's/don'ts are common knowledge. | 1 / 3 |
Actionability | The templates are concrete and copy-paste ready, which is good. However, the skill is primarily a collection of markdown templates rather than executable code or commands. The bash commands in the quick reference section are useful but generic. The skill tells Claude what a handoff document should look like but doesn't provide clear instructions on how to generate one from actual system data or context. | 2 / 3 |
Workflow Clarity | The handoff timing diagram and checklists provide a reasonable sequence, and the sync meeting agenda has time allocations. However, there are no validation checkpoints or feedback loops - no guidance on what to do if the handoff is incomplete, if access verification fails, or how to verify the handoff was successful. The escalation section mentions 'unable to diagnose within 30 min' but lacks concrete verification steps. | 2 / 3 |
Progressive Disclosure | This is a monolithic wall of text with everything inline. Three full templates, multiple checklists, best practices, escalation guidelines, and resources are all crammed into a single file. The templates alone could each be separate files referenced from a concise overview. No bundle files exist to offload content, and no references to external skill files are made. | 1 / 3 |
Total | 6 / 12 Passed |
Validation
100%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
bbc5ade
Table of Contents
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.