CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

handoff-create

Generate a structured handoff document from the current session. Captures scope, relevant files with line numbers, key discoveries, work completed, current status, next steps, and code snippets. Use before ending a session or handing work to another agent.

Quality

93%

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

SKILL.md
Quality
Evals
Security

Quality

Content

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

An exceptionally tight, template-driven skill: the deliverable is fully specified, every rule encodes non-obvious policy, and nothing is padded or misplaced. The only concrete gaps are the unstated source for the timestamp used in filenames/headers and the resolution rule for a user-provided filename. Overall quality is on par with the reference good examples.

DimensionReasoningScore

Conciseness

The ~70-line body contains no explanation of concepts Claude already knows; every line is either path/format specification or non-obvious policy ("add `:line` only when verified at the recorded revision", "A handoff records authorization; it does not grant new permissions"). Only a handful of format-placeholder bullets could be argued as trimmable, which does not reach the 'minor instances of over-explanation' anchor.

5 / 5

Actionability

Guidance is highly concrete: exact output path `claudedocs/handoffs/handoff_YYYYMMDD_HHMMSS.md`, directory creation, `$ARGUMENTS[0]` handling, and a copy-paste-ready template with exact section headings and a 600-word limit. It falls short of fully executable because it never states how to obtain the current timestamp required by the filename and header, and does not clarify whether a bare `$ARGUMENTS[0]` filename is resolved inside `claudedocs/handoffs/`; these are minor gaps, not missing key details.

4 / 5

Workflow Clarity

As a simple single-purpose skill the action is unambiguous: create the directory, compose the document from the fully specified template, save it, then "After saving, confirm the file path" as a completion checkpoint, with embedded verification rules (verify `:line` at the recorded revision, mark unknowns explicitly). The operation is a single non-destructive write, so the destructive/batch validation cap does not apply.

5 / 5

Progressive Disclosure

No bundle files exist and none are needed: the single document template appropriately lives inline, and the body cites no external files (so no broken references). Sections ("Document structure", "Rules") are well-organized and trivially navigable, meeting the well-organized-structure standard for a self-contained skill.

5 / 5

Total

19

/

20

Passed

Description

92%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, third-person description that clearly states both what the skill produces and when to use it, with an unusually concrete enumeration of the document's contents. The only weakness is slightly incomplete synonym coverage of natural trigger terms. It is comparable in quality to the reference good examples.

DimensionReasoningScore

Specificity

"Generate a structured handoff document" plus "Captures scope, relevant files with line numbers, key discoveries, work completed, current status, next steps, and code snippets" enumerates seven concrete capture targets with a specific detail (line numbers), comprehensively covering the skill's output. No coverage gap is apparent, so it matches the comprehensive anchor rather than the 'minor gaps' anchor below.

5 / 5

Completeness

It explicitly answers both: what ("Generate a structured handoff document... Captures scope, ... code snippets") and when ("Use before ending a session or handing work to another agent") with concrete trigger phrasing. The when-clause is specific and explicit, so it exceeds the anchor where 'when' could be more specific.

5 / 5

Trigger Term Quality

Natural phrases users would say are present — "handoff document", "ending a session", "handing work to another agent" — giving good keyword coverage. It is not 5 because common variations like "session summary", "briefing", or "context transfer" are missing, and not 3 because the core natural trigger phrases are all there.

4 / 5

Distinctiveness Conflict Risk

The session-handoff niche ("handoff document", "handing work to another agent") is clear with distinct triggers and minimal overlap risk against adjacent skills like general summarization or documentation. No closely related domain is plausibly confused with these triggers.

5 / 5

Total

19

/

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

FlorianBruniaux/claude-code-ultimate-guide

Path

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