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

87%

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

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.

As a generated redirect stub the body is maximally lean and its single instruction is precise and unambiguous. Its weaknesses are inherent to the stub pattern: all substantive guidance is outsourced to an external, unverifiable path with no fallback, and the bundle ships no supporting files of its own.

Suggestions

Add a brief fallback instruction for when `~/.agents/skills/handoff/SKILL.md` is missing (e.g., check standard shared-skill locations or report the gap) so the skill degrades gracefully instead of dead-ending.

Inline a minimal summary of the handoff workflow (what the document must contain and the commit step) so the skill retains core utility even without the external shared skill loaded.

Move or remove the `scripts/agent-harnesses.py` provenance comment, or place the generator script inside the bundle, so the body references only files that actually ship with the skill.

DimensionReasoningScore

Conciseness

The body is two lines — a provenance comment and "Load and follow the shared skill at `~/.agents/skills/handoff/SKILL.md`" — with zero padding and no explanation of concepts Claude already knows. Every token serves the redirect; this matches anchor 5 ("lean and efficient; assumes Claude's competence") and is clearly above anchor 4 since there is nothing to trim.

5 / 5

Actionability

The single instruction is concrete and executable — an exact path to load and follow — but it is a pure pointer with no fallback or verification if the shared skill is absent, and no task guidance (handoff document creation, committing) lives in this bundle. Anchor 4 ("mostly executable guidance; concrete code or commands with minor gaps") fits better than 5, whose "specific examples cover the common cases" cannot be satisfied when all substance is external and unverifiable.

4 / 5

Workflow Clarity

The one step the body defines (load the shared skill at the given path) is unambiguous, which the simple-skill note rewards. It falls short of 5 because the body fronts a multi-step, state-changing task (author a document and git commit it, per the description) whose entire sequence and validation are delegated to an external file, and there is no checkpoint confirming the shared skill actually loaded — a minor validation gap characteristic of anchor 4.

4 / 5

Progressive Disclosure

The bundle contains no files, and the body's single reference is clearly signaled and one level deep, which is good structure. Minor gaps keep it at anchor 4 rather than 5: the reference targets `~/.agents/skills/handoff/SKILL.md` outside this bundle (unverifiable from the skill itself), and the comment cites `scripts/agent-harnesses.py`, which does not exist in the bundle.

4 / 5

Total

17

/

20

Passed

Description

87%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 well-formed description: concrete about the artifact and actions, explicit and restrictive about triggering, and unambiguous about purpose. The only slack is modest synonym coverage around "handoff" and no detail on document format or commit destination.

DimensionReasoningScore

Specificity

Lists several concrete actions — "Create and commit a durable handoff document", "gives a fresh agent the context and prompt to continue the current planning or implementation work" — naming the artifact, the operation (commit), and the contents. Fits anchor 4 ("lists several specific actions; minor gaps in coverage") rather than 5 because coverage stops at create/commit without detail on format or location, and rather than 3 because it goes beyond naming just 1–2 bare actions.

4 / 5

Completeness

Explicitly answers both questions: 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. This mirrors the anchor-5 example structure exactly; a 4 would require the 'when' to be less explicit, which it is not.

5 / 5

Trigger Term Quality

Good keyword coverage with the natural term "handoff" appearing three times plus the literal invocation token "$handoff" and the phrase "explicitly requests a handoff". It is not 5 because common variations users might say ("hand off", "pass off the work", "transfer context", "continue where you left off") are missing; it is above 3 because the core natural terms are present and repeated.

4 / 5

Distinctiveness Conflict Risk

"Handoff" is a clear niche with distinct triggers, and the restrictive gating ("Use only when explicitly invoked as `$handoff` or when the user explicitly requests a handoff", reinforced by disable-model-invocation) makes accidental triggering for the wrong skill essentially impossible. Minimal conflict risk, matching anchor 5.

5 / 5

Total

18

/

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

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

15

/

16

Passed

Repository

phatblat/dotfiles

Path

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