CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

sce-handover

Write a session handover document, or load one for continuation

Quality

75%

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

Fix and improve this skill with Tessl

tessl review fix ./.pi/skills/sce-handover/SKILL.md

The canonical home for this skill is sce-handover in crocoder-dev/shared-context-engineering

SKILL.md
Quality
Evals
Security

Quality

Content

85%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 tightly written, instruction-only workflow with concrete commands, exact path patterns, explicit validation checkpoints, and an exemplary two-file progressive-disclosure split. Its only weaknesses are minor: slight redundancy in the Input section and one underspecified repository check ('recent commits').

DimensionReasoningScore

Conciseness

The body is efficient and assumes Claude's competence — no basic-concept explanations, no padding — with concrete commands and paths throughout. It falls short of 5 due to minor repetition (the Input section restates 'Never infer the mode from conversation content or repository state' after the rule is already given) and meta-sentences like 'do not define a second required-section list or a different content-validity rule here' that could be tightened.

4 / 5

Actionability

Guidance is mostly fully executable: exact commands (`git status`, `git diff`, `git diff --cached`), exact path patterns with a concrete example (`context/handovers/{plan_name}-{task_id}.md`, `T01`), and explicit rejection rules for the loader. The minor gap keeping it at 4 is step 1's 'Recent commits, when they clarify what just landed', which names no specific command (e.g. `git log -n`) unlike the other repository checks.

4 / 5

Workflow Clarity

Both paths are clearly sequenced with numbered steps and explicit validation checkpoints: the loader validates the path then completeness before presenting; the writer validates the written file against the template's Completeness contract before reporting success, with collision-safe naming ('Never overwrite an existing file') and explicit blocked-state stops. This matches the top anchor — clear sequence, explicit validation, and error-recovery handling (blocked layouts) throughout.

5 / 5

Progressive Disclosure

The split is exemplary: SKILL.md holds only orchestration, while the persisted-file schema lives in `references/handover-template.md` and the terminal output layouts in `references/output.md` — both real files, clearly signaled ('Read references/handover-template.md before composing', 'Render the **Writer success** layout from references/output.md'), and one level deep with no nested reference chains. Content is appropriately split and navigation is easy.

5 / 5

Total

18

/

20

Passed

Description

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

The description gives a clear, terse statement of what the skill does in third person, but it omits any 'when to use' trigger guidance and lacks common synonyms (handoff, resume). It is serviceable yet sits at the midpoint of the rubric, with distinctiveness being its strongest dimension.

Suggestions

Add an explicit 'Use when...' clause, e.g. 'Use when ending a session that should be resumable elsewhere, or when continuing from a previously written handover.'

Include natural synonyms and trigger phrases users would actually say, such as 'handoff', 'session resume', 'pick up where you left off', and the handover path pattern `context/handovers/<file>.md`.

Briefly surface the loader-side validation behavior (rejected paths outside `context/handovers/` or incomplete documents) so the capability boundary is distinguishable from generic note-taking or summary skills.

DimensionReasoningScore

Specificity

The description names the domain ('session handover') and two concrete actions ('Write a session handover document, or load one for continuation'), matching the 'names domain and 1-2 concrete actions, but not comprehensive' anchor. It does not list several specific actions with minor gaps (score 4) — only two actions and no detail on validation, file locations, or continuation behavior.

3 / 5

Completeness

The 'what' is clear (write or load a session handover document), but there is no 'Use when...' clause or equivalent trigger guidance; the 'when' is entirely absent, which caps completeness at 3 per the judging guidelines. This matches the 'clear what but when is missing' anchor exactly rather than sitting between anchors.

3 / 5

Trigger Term Quality

'session handover', 'load', and 'continuation' are relevant natural keywords, but common variations users would say — 'handoff', 'resume session', 'pick up where I left off' — are missing, fitting 'some relevant keywords but missing common variations or synonyms'. It is above score 2 because the terms present are domain-specific and natural, not generic filler.

3 / 5

Distinctiveness Conflict Risk

'Write a session handover document, or load one for continuation' carves a fairly distinct niche (session handovers) with only minor overlap risk against closely related skills like session summaries or memory/context skills. It falls short of score 5 because the description carries no explicit trigger phrases that would fully disambiguate it from those neighbors.

4 / 5

Total

13

/

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

crocoder-dev/shared-context-engineering

Path

.pi/skills/sce-handover/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.