CtrlK
BlogDocsLog inGet started
Tessl Logo

handoff

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

64

Quality

75%

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

100%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The content is concise, well-structured, and actionable, with a clear sequenced workflow and a sensible read-before-update feedback step. No bundle files exist and none are needed for a skill this size.

DimensionReasoningScore

Conciseness

The body is lean and under 20 lines with no padding and no explanation of concepts Claude already knows; every token earns its place, matching the top conciseness anchor.

3 / 3

Actionability

It gives concrete, specific guidance — a fixed file name (HANDOFF.md), a defined section structure, a save location (project root), and a clear final action (tell the user the path) — which is copy-ready actionable instruction even though it is code-free.

3 / 3

Workflow Clarity

The numbered sequence is clear and includes a read-first feedback step (check existence, then read prior context before updating); as a simple single-purpose skill it meets the top anchor for clear, well-organized workflow.

3 / 3

Progressive Disclosure

The skill is under 50 lines with no need for external references and is organized into clear sections, so per the rubric's simple-skills note it qualifies for the top progressive-disclosure anchor.

3 / 3

Total

12

/

12

Passed

Description

50%

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 states a clear concrete action and purpose but lacks an explicit 'Use when...' trigger clause, leaving the 'when to use it' only implied. Adding natural trigger terms would lift the completeness and trigger-term dimensions to their top anchors.

Suggestions

Append an explicit trigger clause, e.g. 'Use when handing off work to a fresh agent, switching context, or resuming a long-running task in a new conversation.'

Expand the action list slightly to be more comprehensive, e.g. 'Write, update, or read a handoff document capturing goal, progress, what worked, what failed, and next steps.'

Add common user-facing variations such as 'handoff', 'context handoff', 'session transfer', and 'resume work' to improve trigger term coverage.

DimensionReasoningScore

Specificity

It names a concrete action ("Write or update a handoff document") and its purpose, but does not list multiple specific actions — matching the anchor that names a domain and some actions without being comprehensive.

2 / 3

Completeness

The 'what' is clear (write/update a handoff document) but 'when' is only implied via the purpose clause; with no explicit 'Use when...' trigger, completeness is capped at 2 per the judging guidelines.

2 / 3

Trigger Term Quality

The natural term "handoff" appears, but there is no explicit trigger guidance and few common variations a user would naturally say, so it matches 'some relevant keywords but missing common variations'.

2 / 3

Distinctiveness Conflict Risk

'handoff document' is a reasonably specific niche unlikely to conflict broadly, yet without richer distinct triggers it sits at 'somewhat specific but could still overlap' rather than a clearly distinct niche.

2 / 3

Total

8

/

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
ykdojo/claude-code-tips
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.