CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

handoff

Write or update a handoff document so the next agent with fresh context can continue this work.

60

Quality

76%

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

Quality

Content

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

This is a lean, well-structured instruction skill: every line directs action, the workflow is correctly sequenced with a read-before-update conditional, and the structure is right-sized for a simple single-purpose task. The only real gap is the absence of a brief template or example showing what a good HANDOFF.md section looks like, and a final check that all five sections are populated.

DimensionReasoningScore

Conciseness

The body is 13 lines with zero padding: no explanation of what a handoff is or why context matters, just a conditional, a five-item section list, a save location, and a reporting instruction. Every token earns its place, matching the 'lean and efficient' anchor.

5 / 5

Actionability

Concrete, executable guidance throughout: a named artifact ('HANDOFF.md'), a read-before-update conditional, five named sections, a save location ('project root'), and a final instruction ('tell the user the file path'). Not a 5 because there is no example or template of the handoff document itself, leaving the desired format per section implicit.

4 / 5

Workflow Clarity

The sequence is clear and correctly ordered (check existence → read prior context → create/update with named sections → save → report path), and the conditional in step 2 acts as a lightweight checkpoint. Not a 5 because there is no validation step confirming all five sections are filled before saving; not a 3 because the sequence is explicit and the operation is non-destructive.

4 / 5

Progressive Disclosure

At 13 lines with no need for external references, the single body with a well-organized step list and bulleted section names is the appropriate structure, matching the under-50-lines guideline for a top score.

5 / 5

Total

18

/

20

Passed

Description

53%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 is concise and names a concrete, distinct artifact, but it only answers 'what' — there is no explicit 'when to use it' clause and few natural trigger phrases beyond the word 'handoff'. Adding a 'Use when...' clause with common synonyms would move completeness and trigger-term quality up a full level.

Suggestions

Add an explicit trigger clause, e.g. 'Use when starting a fresh session to continue prior work, or when the user mentions handoff, handing over, or picking up where we left off.'

Include 1-2 more concrete capabilities or natural synonyms (e.g. 'hand over', 'brief the next agent', 'session summary') to broaden trigger-term coverage without adding fluff.

Clarify the update-vs-create distinction in the description (e.g. 'Create or update HANDOFF.md') to sharpen the 'what' and reduce overlap with generic summarization skills.

DimensionReasoningScore

Specificity

The description names the domain ('handoff document') and one concrete action ('write or update'), which matches the 'names domain and 1-2 concrete actions' anchor. It is not a 4 because it lists no further capabilities (what the handoff contains, when to update vs. create).

3 / 5

Completeness

The 'what' is clear ('write or update a handoff document... continue this work') but there is no 'Use when...' clause or equivalent explicit trigger guidance, which caps completeness at 3 per the judging guidelines. Not a 4 because the 'when' is entirely absent rather than merely weakly implied.

3 / 5

Trigger Term Quality

Relevant keywords like 'handoff document', 'next agent', and 'fresh context' are present, but common variations users would naturally say ('hand over the work', 'brief the next session', 'session summary', 'continue where we left off') are missing. Not a 4 because the natural-phrase coverage is thin beyond the single term 'handoff'.

3 / 5

Distinctiveness Conflict Risk

'Handoff document' is a clear niche term with distinct triggers, giving mostly distinct intent with only minor overlap risk against general documentation or summarization skills. Not a 5 because without an explicit trigger clause it could fire on broader 'document the work' or 'summarize this session' requests.

4 / 5

Total

13

/

20

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 — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

ykdojo/claude-code-tips

Path

skills/handoff/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.