CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

handoff

Distill this session into a short pasteable prompt that starts the next one. Prints the draft for refinement, then copies it to the clipboard on approval.

Quality

78%

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

Quality

Content

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

A tight, instruction-only skill with an exemplary actionability and workflow: numbered steps, concrete thresholds, a full example output, an explicit refinement feedback loop, and an approval-gated copy command with correct heredoc quoting. The only weaknesses are minor — a touch of over-explanation (the colleague analogy, the 'EOF' note) and a single-file structure slightly longer than the simple-skill threshold.

DimensionReasoningScore

Conciseness

The body is lean and mostly assumes Claude's competence (tables, hard cap, example, and rules all earn their tokens), but two spots could be trimmed: the 'hand it to a colleague taking over' analogy paragraph and the explanation that quoted 'EOF' stops shell expansion of backticks and $ — a shell behavior Claude already knows.

4 / 5

Actionability

Fully executable and concrete: the exact `cat <<'EOF' | pbcopy` command, the 'Hard cap: 30 lines or 400 words' threshold, enumerated approval phrases ('good to go', 'ship it', 'copy it'), the decision filter 'can the next session get this by looking?', a complete example handoff, and the exact 'Copied.' confirmation line cover the common cases end to end.

5 / 5

Workflow Clarity

Steps 0–5 are clearly sequenced with explicit checkpoints: the line/word cap acts as a validation step with a remediation instruction ('cut re-derivable content'), the refine cycle is an explicit feedback loop ('Rewrite the whole draft each time and reprint it'), and the clipboard copy is gated on enumerated approval phrases. Not a destructive or batch operation, so no cap applies.

5 / 5

Progressive Disclosure

Sections are well organized and nothing inlined belongs in a separate file (it is all process instruction with no reference dumps), but at roughly 95 lines the body exceeds the under-50-line simple-skill exception, and there is no overview-vs-detail structure to signal. Anchor 4 ('good structure; most content appropriately placed; minor organization gaps') is the best fit.

4 / 5

Total

18

/

20

Passed

Description

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

A concise, concrete, third-person description that clearly states what the skill does across a well-sequenced pipeline, with good distinctiveness. Its main weakness is the complete absence of when-to-use trigger guidance and of the natural vocabulary users would say when they need it.

Suggestions

Add an explicit 'Use when...' clause naming the trigger moments, e.g. 'Use when the session has gotten long and needs to end, before starting a fresh session on unfinished work, or when the user asks for a handoff or pickup prompt' — this lifts both completeness and trigger-term coverage.

Include the natural synonyms users would actually say — 'handoff', 'hand off', 'pick up where we left off', 'context for the next session' — alongside the existing 'session'/'prompt'/'clipboard' terms so the description matches how the need is naturally expressed.

Briefly state what the distilled prompt contains (where work stopped, verified facts, dead ends, constraints) so the 'what' side of the description is comprehensive, not just the pipeline mechanics.

DimensionReasoningScore

Specificity

It lists several specific, sequenced actions — 'Distill this session into a short pasteable prompt', 'Prints the draft for refinement', 'copies it to the clipboard on approval' — matching anchor 4. Not 5 because coverage is narrow (no mention of what content carries forward or the optional note steering), and not 3 because it goes beyond naming the domain with 1–2 actions.

4 / 5

Completeness

The 'what' is clear and concrete (distill → print for refinement → copy on approval), but there is no 'when' guidance at all — no 'Use when...' clause or equivalent trigger hint, which caps completeness at 3 per the judging guidelines. Not 2 because the 'what' is specific rather than vague.

3 / 5

Trigger Term Quality

Relevant keywords are present ('session', 'prompt', 'clipboard', 'pasteable') but common natural variations are missing — 'handoff', 'hand off', 'pick up where we left off', 'context for the next session' — fitting anchor 3 ('some relevant keywords but missing common variations or synonyms'). Not 4 because a fair number of phrases users would naturally say are absent.

3 / 5

Distinctiveness Conflict Risk

It occupies a clear niche (session handoff prompt for the next session) with mostly distinct triggers; the only overlap risk is with closely related summarization/compaction skills. Minor gaps keep it at anchor 4 rather than 5.

4 / 5

Total

14

/

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

joshmanders/dotfiles

Path

claude/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.