CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

handoff-resume

Use when starting a new session and wanting to continue from a previous handoff — reads the latest unrestored handoff document and restores session context

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

Quality

Content

75%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 procedural skill: clear step sequence, concrete commands, explicit decision branches, and no padding or concept-teaching. It misses the top band mainly on validation — no verification after the archive move or frontmatter edit — and a few operations are described rather than given as commands.

Suggestions

Make Step 4 fully executable: give the mv command (e.g. "mv docs/handoffs/<file>.md docs/handoffs/_archive/") and a snippet showing the restored/restored_at frontmatter fields.

Add a verification checkpoint after Step 4, e.g. confirm the file exists in _archive/ and no longer appears in the unrestored listing, before restoring context.

DimensionReasoningScore

Conciseness

The body is lean, assumes competence, and explains no general concepts — every step is operational. Minor trimmable redundancy keeps it below anchor 5: the "Core principle" line and the Overview paragraph both restate what Step 5 and the process already say.

4 / 5

Actionability

Mostly executable: copy-paste commands ("ls docs/handoffs/*.md 2>/dev/null", "git status"), a decision table, and output templates cover the common cases. Gaps: the archive move ("Move the file to docs/handoffs/_archive/") and the frontmatter update are directions rather than a command or snippet, so it falls short of anchor 5's fully copy-paste-ready bar.

4 / 5

Workflow Clarity

A clearly sequenced 5-step process with explicit branching for the one/multiple/none cases and a checkpoint ("run git status to see if the working tree matches expectations"). It lacks an explicit post-action verification (e.g. confirming the file landed in _archive/ or the frontmatter saved), which is exactly the minor validation gap that defines anchor 4 rather than 5.

4 / 5

Progressive Disclosure

Well-organized sections with everything appropriately inline; no bundle files exist and none are needed. The under-50-line exception for a 5 does not strictly apply to this ~93-line body, but structure and navigation are clean, matching anchor 4 with only minor organization gaps (e.g. the Pairs With cross-references could state when to prefer the sibling skills).

4 / 5

Total

16

/

20

Passed

Description

70%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 solid description with a genuine 'Use when...' trigger, third-person voice, and domain-specific language. Its main weakness is an undersold 'what' — it covers only two of the several concrete actions the skill performs and misses the natural synonym "resume".

Suggestions

Expand the 'what' clause to name the full action set, e.g. "...reads the latest unrestored handoff document, marks it as restored, archives it, and continues from its Next Steps".

Add natural trigger synonyms such as "resume" or "pick up where the last session left off" so users phrasing it either way match the skill.

Sharpen distinctiveness from the handoff-creation skill, e.g. "Use when resuming from an existing handoff, not when creating one".

DimensionReasoningScore

Specificity

Names the domain and 1-2 concrete actions ("reads the latest unrestored handoff document and restores session context") but omits the other concrete actions the skill performs (marking consumed, archiving, presenting a summary, continuing from Next Steps). It is above anchor 2 because real actions are stated, below anchor 4 because coverage is not comprehensive.

3 / 5

Completeness

Both parts are present: an explicit "Use when..." trigger and a 'what' clause ("reads the latest unrestored handoff document and restores session context"). The 'what' is thin relative to the actual workflow (no mention of marking restored, archiving, or continuing next steps), so it does not reach anchor 5's fully concrete coverage of both.

4 / 5

Trigger Term Quality

Natural phrases like "starting a new session" and "continue from a previous handoff" are phrases a user would actually say. A few natural terms are missing — notably the synonym "resume" (the skill's own name) and variants like "pick up where I left off" — which keeps it below anchor 5 but above anchor 3's 'missing common variations' only partially applying.

4 / 5

Distinctiveness Conflict Risk

"handoff" is a clear niche with distinct resume-oriented triggers, but there is minor overlap risk with the closely related skill that creates handoffs (a user asking to 'do a handoff' could match either). Mostly distinct, so anchor 4 rather than 5.

4 / 5

Total

15

/

20

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.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

lucianghinda/superpowers-ruby

Path

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.