CtrlK
BlogDocsLog inGet started
Tessl Logo

handoff-protocols

Manages work transitions between team members or agents by creating structured handoff documents, summarizing project status, documenting key decisions, blockers, and open questions, and generating onboarding briefs. Use when someone needs to hand off, hand over, or transition a project; pass work to another person or agent; brief a colleague taking over; prepare a shift change summary; or onboard someone mid-task. Produces ready-to-use handoff documents covering current status, next steps, known issues, technical context, and communication templates for both planned and unplanned transfers.

70

Quality

63%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./packages/core/src/methodology/packs/collaboration/handoff-protocols/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

100%

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 an excellent skill description that hits all the marks. It provides specific concrete actions, comprehensive natural trigger terms covering multiple phrasings, an explicit 'Use when...' clause, and a clearly distinct niche. The description is thorough without being padded, and uses proper third-person voice throughout.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: creating structured handoff documents, summarizing project status, documenting key decisions/blockers/open questions, generating onboarding briefs. Also specifies output contents: current status, next steps, known issues, technical context, and communication templates.

3 / 3

Completeness

Clearly answers both 'what' (creating structured handoff documents, summarizing status, documenting decisions/blockers/questions, generating onboarding briefs) and 'when' with an explicit 'Use when...' clause listing multiple trigger scenarios.

3 / 3

Trigger Term Quality

Excellent coverage of natural terms users would say: 'hand off', 'hand over', 'transition a project', 'pass work', 'brief a colleague taking over', 'shift change summary', 'onboard someone mid-task'. These are varied and natural phrasings covering many ways a user might express this need.

3 / 3

Distinctiveness Conflict Risk

Occupies a clear niche around work transitions and handoffs between team members or agents. The specific trigger terms like 'hand off', 'shift change', 'transition a project' are distinct and unlikely to conflict with general documentation or project management skills.

3 / 3

Total

12

/

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 overly verbose handoff guide that reads more like a general project management handbook than a targeted skill for Claude. Its main strength is the concrete handoff document template and communication templates, but these are buried in excessive generic advice. The content would benefit significantly from aggressive trimming of obvious guidance and splitting the large templates into referenced files.

Suggestions

Cut the content by at least 50% — remove sections like 'Receiving a Handoff' (generic advice Claude knows), 'Handoff Anti-Patterns' (one-liner that adds little), and trim the handoff type table which explains obvious concepts.

Extract the handoff document template and communication templates into separate referenced files (e.g., HANDOFF_TEMPLATE.md, COMMS_TEMPLATES.md) to improve progressive disclosure and reduce the main file size.

Add validation checkpoints to the workflow, such as verifying the handoff document covers all essential sections before sharing, and confirming the receiver can build/run the code before considering the handoff complete.

Make the skill more actionable by providing specific instructions for how Claude should gather project context (e.g., 'Read recent git log, scan open issues, check CI status') rather than just listing template placeholders to fill in.

DimensionReasoningScore

Conciseness

The skill is extremely verbose at ~200+ lines. Much of the content is generic project management advice that Claude already knows (e.g., 'Read documentation before asking questions', 'Acknowledge receipt', what a handoff meeting involves). The anti-patterns section, receiving a handoff section, and communication templates add significant bulk with minimal novel instruction. The handoff document template alone is massive and could be condensed.

1 / 3

Actionability

The skill provides concrete templates and checklists (handoff document structure, bash commands for code state, communication templates), which is good. However, much of it is placeholder-heavy markdown templates rather than executable guidance — it tells Claude what sections to fill in but doesn't provide specific logic for how to gather or synthesize the information. The bash commands are a nice concrete touch but are generic.

2 / 3

Workflow Clarity

There is a clear sequence for the handoff meeting (before/during/after) and code preparation steps, but there are no validation checkpoints or feedback loops. For example, there's no step to verify the handoff document is complete before sharing, no mechanism to check if the receiver actually has access, and no error recovery guidance if the code state preparation fails.

2 / 3

Progressive Disclosure

The entire skill is a monolithic wall of text with no references to external files. The handoff document template alone could be a separate referenced file. Communication templates, the meeting checklist, and the quality checklist could all be split out. Everything is inline, making the skill very long and hard to navigate. The brief 'Integration with Other Skills' section at the end references other skills but doesn't link to them.

1 / 3

Total

6

/

12

Passed

Validation

90%

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

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

10

/

11

Passed

Repository
rohitg00/skillkit
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.