CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

handoff-update

Update an existing handoff document with current session progress. Applies section-specific merge rules: append-only for Work Done (never deletes history), replace for Status and Next Steps, merge for Files and Discoveries. Falls back to creating a new handoff if no source file is found.

Quality

80%

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

Quality

Content

82%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, well-structured instruction-only skill: an unambiguous resolution order, concrete per-section merge rules with a strict history-preservation invariant, and an explicit confirmation checklist. The remaining gaps are minor — underspecified fallback content, no error-recovery loop, and a dangling reference to a parent guide's section.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence: no concepts are explained that Claude already knows, every sentence is directive ("Read the resolved file completely. Parse all sections as the baseline for the merge."), and the merge rules are compressed into a table. This matches the 5 anchor (every token earns its place); the only candidate for trimming is the two-line attribution footer, which is too minor to drop it to the 4 anchor's "minor instances of over-explanation".

5 / 5

Actionability

Guidance is concrete and executable for the main path: a three-tier resolution order, a literal fallback path pattern ("claudedocs/handoffs/handoff_YYYYMMDD_HHMMSS.md"), per-section rules like "Never remove entries. Include commit hashes", and a specific confirmation checklist. It sits at the 4 anchor rather than 5 because of minor gaps: the fallback path never specifies what content a newly created handoff contains, and "record a new contract revision" assumes unstated process knowledge. It is well above 3 since nothing is pseudocode or merely descriptive.

4 / 5

Workflow Clarity

Four clearly sequenced steps with an explicit post-save verification checklist in Step 4 ("File path updated / How many new Work Done items were added / The updated Status"), and the risky rewrite is guarded by the strict append-only rule. This matches the 4 anchor (clear sequence, most checkpoints present, minor validation gaps); it is not 5 because there is no error-recovery feedback loop (e.g. re-verify that no prior Work Done entries were lost after rewriting), and not 3 because a concrete checkpoint step is explicitly present.

4 / 5

Progressive Disclosure

The skill is short (~43 lines), self-contained with no bundle files, and organized into four well-labeled step sections plus a rules table, which per the simple-skill note could merit a 5. It lands at the 4 anchor instead because the footer points to "the Handoff Triad pattern documented in this guide's Session Handoff Pattern section" — a reference to material not present in the skill or any bundle file, a minor organization/navigation gap; it is far above the 3 anchor since nothing that belongs in a separate file is inlined.

4 / 5

Total

17

/

20

Passed

Description

71%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 highly specific, well-scoped description that clearly communicates what the skill does, including its per-section merge semantics and fallback behavior. Its main weakness is the complete absence of any 'when to use' trigger guidance, which caps completeness, and modest keyword synonym coverage.

Suggestions

Add an explicit trigger clause, e.g. "Use when the user asks to update, add to, or refresh an existing handoff or session summary during or at the end of a session."

Include a few natural synonyms users might say, such as "session summary", "context handoff", or "wrap-up notes", alongside "handoff document".

Clarify the boundary with sibling commands (e.g. "For creating a fresh handoff from scratch, use the handoff create command instead") to reduce overlap with the fallback-creation path.

DimensionReasoningScore

Specificity

The description enumerates multiple concrete actions with comprehensive coverage of the skill's behavior: "Update an existing handoff document with current session progress", per-section merge rules ("append-only for Work Done (never deletes history), replace for Status and Next Steps, merge for Files and Discoveries"), and the fallback "Falls back to creating a new handoff if no source file is found". This matches the 5 anchor (multiple specific concrete actions, comprehensive) rather than 4, since no capability of the skill is left uncovered; it is well above the 3 anchor's "1-2 concrete actions".

5 / 5

Completeness

The "what" is clearly and specifically stated (update with merge rules plus fallback), but there is no "Use when..." clause or equivalent explicit trigger guidance — the description never states when to invoke it. Per the judging guideline, a missing 'Use when' clause caps completeness at 3; it is not 2 because the "what" half is fully clear, and not 4 because "when" is entirely absent rather than just imprecise.

3 / 5

Trigger Term Quality

"handoff document" and "session progress" are natural phrases a user would say, repeated via "handoff" in several forms. It falls at the 4 anchor (good keyword coverage, a few natural terms missing) rather than 5 because common synonyms like "session summary", "context handoff", or "standup/continuation notes" are absent, though no file extensions are relevant to this domain.

4 / 5

Distinctiveness Conflict Risk

"Update an existing handoff document" carves out a clear niche distinct from generic document skills, but the fallback "Falls back to creating a new handoff if no source file is found" overlaps with a sibling handoff-creation skill (the body references the Handoff Triad with /handoff:resume). This matches the 4 anchor (mostly distinct, minor overlap risk with closely related skills); it is not 5 because that overlap exists, and not 3 because the scope is far narrower than "Works with document files".

4 / 5

Total

16

/

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