CtrlK
BlogDocsLog inGet started
Tessl Logo

on-call-handoff-patterns

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

1.53x
Quality

58%

Does it follow best practices?

Impact

95%

1.53x

Average score across 3 eval scenarios

SecuritybySnyk

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.md
SKILL.md
Quality
Evals
Security

Quality

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.'

DimensionReasoningScore

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.

DimensionReasoningScore

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
Dicklesworthstone/pi_agent_rust
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.