CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

handoff

Manages the handoffs/ directory — a chronological log of session-ending state snapshots. Write a handoff when finishing a session or completing a feature. Read the latest handoff when resuming a project. The next agent reads ONLY the most recent handoff file; older files are the user's version history and must not be read by the agent. Load this skill when asked to hand off, wrap up, or when resuming a project that has a handoffs/ directory.

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

88%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.

The body is a lean, highly actionable protocol: exact naming rules, a complete template, an unambiguous read procedure, and a table clarifying how handoffs relate to other project files. Only minor conciseness trims and the absence of any bundle split keep it from full marks.

DimensionReasoningScore

Conciseness

The body is efficient — the naming convention, template, and reading procedure all earn their tokens, with no explanations of concepts Claude already knows. Minor redundancy keeps it from a 5: the lexicographic-sort-equals-latest rule is stated in both the naming and reading sections, and the read-only-the-latest rule appears three times (intro, writing, reading).

4 / 5

Actionability

Fully concrete for an instruction-only skill: an exact filename pattern with worked examples, a copy-paste-ready markdown template with per-section placeholders and fallback lines ("Nothing in progress.", "No special context."), and a numbered reading procedure.

5 / 5

Workflow Clarity

Both workflows are clearly sequenced: writing has explicit trigger conditions (feature complete, session ends mid-feature, explicit /handoff) plus a self-containment rule, and reading is an unambiguous 5-step list with the read-only-latest guard as an explicit correctness checkpoint. No destructive or batch operations are involved, so no validation loop is required.

5 / 5

Progressive Disclosure

A single self-contained file with well-organized, clearly headed sections (naming, writing, reading, relation to other files) and no nested references. At ~127 lines the under-50-line auto-5 exception doesn't apply, and all inline content is needed on every invocation, so the structure is good but not maximally split.

4 / 5

Total

18

/

20

Passed

Description

83%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 description that clearly states the domain, concrete actions, and an explicit load-trigger clause with natural trigger phrases. Its only weaknesses are slightly generic "wrap up" triggers and a thin set of synonyms beyond the core "handoff" terms.

DimensionReasoningScore

Specificity

"Write a handoff when finishing a session", "Read the latest handoff when resuming a project", and "Manages the handoffs/ directory" name several concrete, specific actions. Falls short of 5 because coverage is limited to two core actions (write, read-latest) rather than a comprehensive action list.

4 / 5

Completeness

Explicitly answers what ("Manages the handoffs/ directory... Write a handoff... Read the latest handoff") and when ("Load this skill when asked to hand off, wrap up, or when resuming a project that has a handoffs/ directory") with concrete trigger phrases.

5 / 5

Trigger Term Quality

"hand off", "wrap up", "resuming a project", and "handoffs/" are natural phrases a user would say, giving good keyword coverage. Missing common variations like "session summary", "context handoff", or "pick up where we left off", so not a 5.

4 / 5

Distinctiveness Conflict Risk

The handoffs/-directory protocol is a clear, distinct niche unlikely to trigger the wrong skill. Minor overlap risk remains because "wrap up" and "finishing a session" are generic phrases that could match general session-summary or project-management skills.

4 / 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

relative_links

Relative link issues: 2 suspicious

Warning

Total

15

/

16

Passed

Repository

g23polar/dotfiles

Path

pi/agent/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.