CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

handover-document-creator

Write a session handover document in .context/handovers/ so another agent or session can resume the work without re-deriving context. Use when a session is ending (or pausing) with work still in progress, when the user asks to 'write a handover', 'document what's outstanding for the next session', 'hand this off', or 'summarise where we got to', or when a long-running task is about to be interrupted (context limit, user stepping away, switching worktrees). Covers the frontmatter contract, required sections (Session Summary, Completed, Outstanding, Current State, Next Steps, References), the JSON Schema and shell validator that check a handover's shape, and how a follow-up session should pick one up and close it out.

Quality

94%

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

92%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-engineered instruction-only skill body: every workflow step is executable, validation is built into both writing and pickup with explicit feedback loops, and detail is cleanly pushed to real, one-level-deep bundle files that deliver what the body promises. The only flaw is redundancy — the snapshot-not-living-document rule and the typology boundary are each restated two to three times across sections.

DimensionReasoningScore

Conciseness

The body is instruction-dense with no explanations of concepts Claude already knows, but it repeats itself: the snapshot-vs-in-place-edit rule appears three times (naming convention section, Relationship section, and the second anti-pattern), the pointer to references/typology-and-lifecycle.md is given twice in near-identical words, and the validator is described in both the Assets section and the References table. These are minor instances that could be trimmed, matching the 4 anchor rather than the lean 5.

4 / 5

Actionability

Fully executable guidance throughout: exact commands (git status, git log -1, git stash list, git stash push -u -m "<unique-tag>"), a copy-paste validator invocation (bash <skill-dir>/scripts/validate-handover.sh .context/handovers/), a commit message format (docs(handover): <short description>), a complete frontmatter YAML example, and a concrete filename pattern. The BAD/GOOD anti-pattern pairs are also concrete.

5 / 5

Workflow Clarity

Both workflows (writing and picking up) are numbered with explicit validation checkpoints and feedback loops: "Run the validator before considering the handover done... Fix anything it flags" and "Re-run the validator to confirm the frontmatter edit didn't break the schema". Conditional handling (partially resolved outstanding work) is specified, matching the 5 anchor's explicit validation with error-recovery loops.

5 / 5

Progressive Disclosure

The body is a genuine overview with detail split appropriately: section-by-section detail in references/document-structure.md, typology/lifecycle in references/typology-and-lifecycle.md, the contract in assets/schemas/handover-frontmatter.schema.json, and structure in assets/templates/handover.yaml — all verified to exist and to contain what the body claims. References are one level deep and clearly signaled both inline and via the References table's 'When to Use' column.

5 / 5

Total

19

/

20

Passed

Description

95%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: it states exactly what the skill produces and where, gives an explicit and richly phrased 'Use when' trigger set covering both user-requested and situational invocations, and carves out a distinct niche. The only weakness is that the second half narrates skill contents ("Covers the frontmatter contract...") rather than framing them as actions, which reads as padding against the conciseness guideline.

DimensionReasoningScore

Specificity

Concrete actions are named ("Write a session handover document in .context/handovers/", the JSON Schema and shell validator that check a handover's shape, picking one up and closing it out) with an enumerated required-sections list. It stops short of the 5 anchor's multiple distinct action verbs because the coverage list ("Covers the frontmatter contract, required sections (...)") narrates skill contents rather than stating actions.

4 / 5

Completeness

Explicitly answers both: what ("Write a session handover document in .context/handovers/ so another agent or session can resume the work without re-deriving context") and when ("Use when a session is ending (or pausing) with work still in progress, when the user asks to... or when a long-running task is about to be interrupted"). Trigger phrases are concrete and enumerated.

5 / 5

Trigger Term Quality

Comprehensive natural trigger phrases users would actually say: "'write a handover'", "'document what's outstanding for the next session'", "'hand this off'", "'summarise where we got to'", plus situational terms like "context limit" and "switching worktrees". No common variation is missing.

5 / 5

Distinctiveness Conflict Risk

A clear niche (session handover documents under .context/handovers/) with distinct triggers ("handover", "hand this off", session-end interrupts). The only minor overlap risk is "'summarise where we got to'" matching a generic summarization request, which is too slight to drop below the 5 anchor.

5 / 5

Total

19

/

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: 4 deeper-than-1-level

Warning

Total

15

/

16

Passed

Repository

pantheon-org/tekhne

Path

skills/agentic-harness/handover-document-creator/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.