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
63%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./packages/core/src/methodology/packs/collaboration/handoff-protocols/SKILL.mdQuality
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.
| Dimension | Reasoning | Score |
|---|---|---|
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.
| Dimension | Reasoning | Score |
|---|---|---|
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.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
a9e5c83
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.