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 unit of work. 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

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.

A well-crafted instruction-only skill: fully actionable with an exact naming scheme, a copy-paste template, and unambiguous procedures, all at appropriate brevity. The minor deductions come from some redundancy (the only-latest rule and UML.md's role are each stated twice), the absence of a post-write ordering verification step, and the 50-line template that could be split into a references/ file. No dimension falls below 4.

DimensionReasoningScore

Conciseness

The body is efficient and teaches only novel conventions (naming scheme, template, protocol) without explaining concepts Claude already knows, fitting anchor 4. It is below anchor 5 because of repeated content: the agent-reads-only-the-latest rule appears in both the intro and the reading steps, and UML.md's architectural role is stated in step 5 and again in the closing table.

4 / 5

Actionability

Everything is executable: an exact filename format with worked examples, a complete copy-paste-ready markdown template with fallback text for empty sections, and a numbered reading procedure — matching anchor 5's copy-paste-ready guidance covering the common cases. For an instruction-only skill this level of concreteness meets the top anchor despite having no code.

5 / 5

Workflow Clarity

Both procedures are clearly sequenced — the writing side has an explicit three-condition checklist of when to write, and the reading side is five unambiguous numbered steps — matching anchor 4. It misses anchor 5 because there is no post-write verification checkpoint (e.g., confirming the new file sorts lexicographically after the previous latest, the exact invariant the whole scheme depends on).

4 / 5

Progressive Disclosure

The single file is well-organized with clear section headers (naming, writing, reading, relation to other files) and no nested references, matching anchor 4's good structure with minor organization gaps. At ~128 lines with a ~50-line template, the content exceeds the under-50-line simple-skill exception, and the template is a natural candidate for a references/ file, so anchor 5's appropriately-split structure is not fully met.

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 strong description: concrete actions in third-person imperative voice, an explicit multi-trigger "Load this skill when..." clause, and a well-defined niche around the handoffs/ directory. The only weaknesses are the slightly generic lead verb "Manages" and a few missing natural trigger synonyms. All dimensions score 4–5 with completeness and distinctiveness at the top anchor.

DimensionReasoningScore

Specificity

The description lists several concrete actions — "Write a handoff when finishing a session or completing a unit of work", "Read the latest handoff when resuming a project", and the read-only-most-recent rule — matching anchor 4's several specific actions with minor gaps. It falls short of anchor 5's comprehensive coverage because the lead verb "Manages the handoffs/ directory" is generic and the naming/template mechanics that make up much of the skill are unstated.

4 / 5

Completeness

It clearly answers both what ("a chronological log of session-ending state snapshots"; write on finish, read latest on resume) 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, exactly matching anchor 5. It is above anchor 4 because the when-clause is explicit and multi-triggered rather than merely adequate.

5 / 5

Trigger Term Quality

Natural trigger phrases are present — "asked to hand off, wrap up, or when resuming a project that has a handoffs/ directory" — giving good keyword coverage a user would naturally say. A few natural variants are missing (e.g., "continue where we left off", "pick up the session"), keeping it at anchor 4 rather than the comprehensive synonym coverage of anchor 5.

4 / 5

Distinctiveness Conflict Risk

The handoffs/ directory is a clear niche with distinct triggers (hand off, wrap up, resuming a project with a handoffs/ directory), giving minimal conflict risk with other skills — matching anchor 5. Only the mildly generic "wrap up" phrase hints at overlap, which is insufficient to drop to anchor 4's minor-overlap framing.

5 / 5

Total

18

/

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

g23polar/pi-project-memory

Path

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.