CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

handoff

Create and commit a durable handoff document that gives a fresh agent the context and prompt to continue the current planning or implementation work. Use only when explicitly invoked as `$handoff` or when the user explicitly requests a handoff.

Quality

88%

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

96%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 instructional skill: fully executable commands, a complete output template, and a workflow with explicit validation and failure-recovery paths, all with no padding. The only structural improvement is moving the long document template into a bundle file so SKILL.md stays a lean overview.

DimensionReasoningScore

Conciseness

The body is entirely prescriptive — rules, a six-step workflow, exact commands, and the output template — with zero space spent explaining concepts Claude already knows. Every section ("Act immediately", the one-command git inspection block, the commit commands) earns its tokens; it matches the 'lean and efficient; every token earns its place' anchor rather than the 4 anchor, which expects over-explanation to trim.

5 / 5

Actionability

Guidance is fully executable: a copy-paste git inspection one-liner, an exact output path pattern (`docs/handoffs/YYYY-MM-DD-<topic>.md`), a complete markdown template, and ready commit commands (`git add -- "docs/handoffs/..."`, `git commit -m "docs: Add <topic> handoff"`). This matches the 'copy-paste ready' anchor; not 4 because there are no gaps in the common cases.

5 / 5

Workflow Clarity

The six steps are clearly sequenced with explicit validation and recovery: step 4 reviews the document for completeness and forbids leftover placeholders, and step 5 handles commit failure ("keep the document written, report the failure and exact remediation"), plus the non-git-repository fallback. It matches the anchor with explicit validation steps and feedback loops; not 4 because checkpoints and failure paths are all explicit.

5 / 5

Progressive Disclosure

Good structure (Rules / Workflow / template) with no external files needed, but the ~74-line inline document template is substantial content that could live in a `references/` or `assets/` file to slim the always-loaded SKILL.md. Matches 'good structure; most content appropriately placed; minor organization gaps'; not 5 because the file is over 50 lines and the template is a candidate for one-level-deep extraction, and not 3 because nothing is buried or misfiled.

4 / 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 strong, well-scoped description that clearly states both what the skill does and exactly when to use it, with an explicit guard against unintended triggering. Its main weakness is limited keyword breadth — only the single term "handoff" — and just two concrete actions named.

Suggestions

Add one or two natural trigger variations users might say, e.g. "or when the user asks to hand over / summarize the session for a new agent", to broaden trigger-term coverage.

Name one or two more concrete capabilities (e.g. "records decisions, open questions, and next steps from the current session") to raise specificity from 1-2 actions to several.

DimensionReasoningScore

Specificity

"Create and commit a durable handoff document" names the domain and two concrete actions, matching the anchor for 1-2 concrete actions without comprehensive coverage. Not 4 because it does not enumerate several specific actions (e.g., what the document contains or how it is structured); not 2 because the actions are concrete rather than generic.

3 / 5

Completeness

The description explicitly answers both: what ("Create and commit a durable handoff document that gives a fresh agent the context and prompt to continue the current planning or implementation work") and when ("Use only when explicitly invoked as `$handoff` or when the user explicitly requests a handoff"), with concrete trigger phrases. Not 4 because the 'when' clause is already fully explicit rather than needing more specificity.

5 / 5

Trigger Term Quality

"handoff" (and "$handoff") is the single natural keyword a user would say, but common variations like "hand over", "session summary", or "continue where you left off" are absent. Not 4 because coverage is limited to one term family; not 2 because that term is directly relevant and naturally spoken.

3 / 5

Distinctiveness Conflict Risk

"Use only when explicitly invoked as `$handoff` or when the user explicitly requests a handoff" carves out a clear niche with distinct triggers and very low risk of firing for unrelated skills. Not 4 because the explicit-invocation restriction leaves almost no overlap risk with summarization or documentation skills.

5 / 5

Total

16

/

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

phatblat/dotfiles

Path

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