CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

handoff-resume

Load a handoff document and resume work from where a previous session left off. Parses scope, file references, completed work, and next steps, then checks live state and existing authorization before proceeding.

Quality

86%

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 exemplary lean, agent-oriented skill body: a clear four-step workflow with explicit validation checkpoints, completion criteria, error-recovery feedback loops, and safety-minded Notes that prevent blind repetition of side effects. The only minor weakness is a few abstract directives and the absence of examples that would make the guidance fully copy-paste-ready.

DimensionReasoningScore

Conciseness

The ~24-line body is lean and dense with non-obvious guidance ('Preserve Work Done as append-only history. It is a record of prior claims, not an authoritative statement of current state.'), explaining nothing Claude already knows and wasting no tokens. It does not fit anchor 4 because there is no over-explanation to trim.

5 / 5

Actionability

Guidance is concrete and executable for an instruction-only skill: a specific fallback path ('list files in claudedocs/handoffs/'), an exact parse checklist ('Files involved (with line numbers)', 'Next steps (ordered)'), and explicit decision rules in step 4. It falls short of anchor 5 because a few directives remain abstract ('applicable decisions, and ownership') and no examples or templates are given for the common cases.

4 / 5

Workflow Clarity

The four-step sequence includes explicit validation (step 3 reconciliation plus 'Revalidate checks needed for the next action when their evidence is stale'), feedback loops for error recovery ('If the path does not exist... ask the user which one to load'; 'If next steps conflict with live evidence, resolve the conflict before dependent changes'), explicit completion criteria ('Done when...'), and a literal checklist in step 2. This is not a destructive/batch operation skill, so the score-3 cap does not apply.

5 / 5

Progressive Disclosure

The skill is under 50 lines, needs no external references, and is organized into clear '## Steps' and '## Notes' sections with no inlined content that belongs elsewhere. Per the rubric's simple-skill guideline, this earns a 5 on well-organized sections alone.

5 / 5

Total

19

/

20

Passed

Description

75%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 specific, concrete, and distinctive description that clearly communicates what the skill does across its full workflow. Its one material weakness is the absence of an explicit 'Use when...' trigger clause, which caps completeness and leaves trigger terms implied rather than stated.

Suggestions

Append an explicit trigger clause, e.g. 'Use when the user references a handoff document, asks to resume or continue from a previous session, or wants to pick up where the last session left off.'

Add natural trigger synonyms and variations (resume, continue, pick up, hand-off, session notes) so the skill matches the phrasings users actually say.

Consider making 'live state' slightly more concrete (e.g. 'current branch, commits, and uncommitted changes') to sharpen the what even further.

DimensionReasoningScore

Specificity

The description enumerates multiple concrete actions covering the workflow end-to-end: 'Load a handoff document', 'Parses scope, file references, completed work, and next steps', 'checks live state and existing authorization before proceeding' — comparable in breadth and concreteness to the anchor-5 example. It does not fit anchor 4 ('minor gaps in coverage') because no meaningful capability of this skill is left unstated.

5 / 5

Completeness

The 'what' is clear and specific, but there is no 'Use when...' clause or equivalent explicit trigger guidance — 'resume work from where a previous session left off' only weakly implies the 'when'. The judging guideline explicitly caps completeness at 3 in this case; it scores above anchor 2 because the 'what' is fully articulated.

3 / 5

Trigger Term Quality

'handoff document', 'resume work', 'where a previous session left off' are phrases users would naturally say when needing this skill. It falls short of anchor 5 because common variations and synonyms ('continue', 'pick up where we left off', 'hand-off') are absent and the terms are embedded in capability prose rather than framed as triggers.

4 / 5

Distinctiveness Conflict Risk

'handoff document' and 'previous session' carve out a clear niche with distinct triggers; virtually no other skill would compete for these terms. It exceeds anchor 4 because there is no closely related skill with which it risks overlap.

5 / 5

Total

17

/

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