CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

on-call-handoff-patterns

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

Quality

65%

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

Fix and improve this skill with Tessl

tessl review fix ./plugins/AI-Agents-Safe-Coding-Skills-claude/skills/on-call-handoff-patterns/SKILL.md

The canonical home for this skill is on-call-handoff-patterns in administrakt0r/AI-Agents-Safe-Coding-Skills

SKILL.md
Quality
Evals
Security

Quality

Content

67%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.

The content is highly actionable — realistic, copy-paste-ready templates, checklists, and executable commands that cover the common handoff scenarios — with a reasonably clear process flow and validation checkpoints. Its weaknesses are token efficiency (boilerplate filler sections and a fully worked 165-line example) and progressive disclosure: the skill is a monolith whose only reference points to a nonexistent file.

Suggestions

Move the three templates (and the pre/during/post-shift checklists) into a references/ file each, keeping SKILL.md as a concise overview with clearly signaled one-level-deep links; this also fixes the broken `resources/implementation-playbook.md` reference, which points to a file that does not exist.

Delete the tautological "Do not use this skill when" bullets and the generic Instructions section ("Clarify goals, constraints, and required inputs. Apply relevant best practices and validate outcomes.") — they add no skill-specific guidance.

Replace Template 1's fully populated 165-line worked example with a lean skeleton template, or relocate the worked example to a separate examples file, and remove the "Best Practices" do's/don'ts that duplicate the checklists.

DimensionReasoningScore

Conciseness

The body mostly avoids explaining concepts Claude already knows, but contains noticeable padding: a tautological "Do not use this skill when" section ("The task is unrelated to on-call handoff patterns"), generic Instructions boilerplate ("Apply relevant best practices and validate outcomes"), a "Best Practices" do's/don'ts section that repeats the checklists, and a fully populated 165-line worked example (Template 1) that could be tightened to a skeleton. This fits 'mostly efficient but includes some unnecessary explanation or could be tightened' rather than level 4's 'minor instances'.

3 / 5

Actionability

Three copy-paste-ready templates cover the common cases (full shift handoff, quick async handoff, mid-incident handoff), the checklists and sync-meeting agenda are directly usable, and the quick-reference commands (kubectl, psql, redis-cli) are executable. This matches 'fully executable; copy-paste ready; specific examples cover the common cases' — the small amount of abstract filler does not reduce the concrete coverage.

5 / 5

Workflow Clarity

The process is clearly sequenced (write handoff doc → sync call → verify alerting), with explicit validation checkpoints in the checklists ("Verify PagerDuty is routing to you", "Verify PagerDuty routing changed") and conditional escalation guidance ("If not improving, escalate"). It falls short of level 5 because the workflow is fragmented across multiple sections rather than one coherent flow, and the timing diagram is internally inconsistent (15+15+5 = 35 min of incoming tasks inside a stated 30-min overlap).

4 / 5

Progressive Disclosure

Everything is inlined in one ~450-line file: the three templates, checklists, and escalation guidance are content that clearly belongs in separate reference files (Template 1 alone is 165 lines), matching level 2's 'content that clearly belongs in separate files is inlined'. The single external pointer — `resources/implementation-playbook.md` — references a file that does not exist in the bundle (no references/ directory is present), which is worse than level 3's 'references present but not clearly signaled'. Section headers are well-organized, but structure alone cannot offset the monolithic inlining and broken reference.

2 / 5

Total

14

/

20

Passed

Description

48%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.

The description clearly identifies its domain but reads as a topic statement rather than a capability statement: it names no concrete actions, omits any 'use when' trigger guidance, and never uses the word "handoff" — the term users would most naturally say. It is serviceable but under-realizes the description's job of enabling skill triggering.

Suggestions

Add an explicit trigger clause, e.g. "Use when transitioning on-call shifts, writing shift handoff summaries, or handing off mid-incident", to satisfy the missing 'when' guidance and lift completeness.

Include the natural keywords "handoff"/"handover" (and "rotation") — the most common user phrasing for this skill is currently absent from the description.

Replace abstract outcome phrasing ("ensuring continuity, context transfer, and reliable incident response") with 2-3 concrete actions such as "write shift handoff documents, run handoff sync meetings, and verify alerting setup".

DimensionReasoningScore

Specificity

The description names the domain ("on-call shift transitions") but lists no concrete actions the skill performs — "ensuring continuity, context transfer, and reliable incident response" are abstract outcomes, not actions like writing handoff documents or running sync meetings. This matches 'Names the domain but actions are minimal or generic' rather than the level-3 anchor, which requires 1-2 explicit concrete actions.

2 / 5

Completeness

The 'what' is stated at the domain level ("Effective patterns for on-call shift transitions") but there is no 'Use when...' clause or equivalent trigger guidance, which caps completeness at 3 per the judging guidelines. It is not level 2 because the 'what' is more specific than 'helps with documents'-level vagueness, though the missing 'when' keeps it from level 4.

3 / 5

Trigger Term Quality

Relevant keywords are present ("on-call", "shift transitions", "incident response"), but the single most natural user term for this skill — "handoff"/"handover" — is entirely absent, as are "rotation" and "pager". This fits 'Some relevant keywords but missing common variations or synonyms'; it does not reach level 4's 'good keyword coverage' given the core term is missing.

3 / 5

Distinctiveness Conflict Risk

"On-call shift transitions" carves out a fairly distinct niche, so the description is mostly distinguishable from other skills. Minor overlap risk remains with incident-response and postmortem skills via the "reliable incident response" phrasing, keeping it below level 5's 'clear niche with distinct triggers'.

4 / 5

Total

12

/

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.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

plugins/AI-Agents-Safe-Coding-Skills-claude/skills/on-call-handoff-patterns/SKILL.md

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.