CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

handoff-coordinator

Clean transitions between agents and sessions. Use when preparing handoffs, serializing state, bridging context between agents, or coordinating multi-agent workflows.

Quality

71%

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 ./.claude/skills/handoff-coordinator/SKILL.md

The canonical home for this skill is handoff-coordinator in fernandezbaptiste/Skrillz

SKILL.md
Quality
Evals
Security

Quality

Content

57%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 has a solid structure with genuinely executable Quick Start code that matches the real script API, but it is undermined by a padded ASCII diagram, validation steps that are only implicit, and two dead file references (references/AGENT-TRANSITIONS.md and scripts/handoff_protocol.py) that break navigation.

Suggestions

Remove or drastically shrink the ASCII workflow diagram — a compact 3-line list (source: complete work + create package; coordinator: validate + serialize; target: load + verify) conveys the same sequence at a fraction of the tokens.

Fix the dead references: either create references/AGENT-TRANSITIONS.md and scripts/handoff_protocol.py, or drop them from the References and Scripts sections so every listed path resolves.

Add an explicit validation checkpoint to the workflow (e.g., 'Before executing: verify the package JSON is loadable with coordinator.load_handoff(package.id); only then overwrite current.json'), since execute_handoff silently overwrites the current handoff state.

DimensionReasoningScore

Conciseness

The body is mostly lean (Quick Start code, a compact package example, a types table), but the ~24-line ASCII box diagram is pure padding — 'Complete current work', 'Save state to files', 'Continue work' are steps Claude can infer, and the box-drawing adds no information. This is more than the minor trimming of anchor 4, but the padding is confined to one section rather than 'several padded sections' of anchor 2.

3 / 5

Actionability

The Quick Start provides real executable Python that matches the actual HandoffCoordinator API in scripts/handoff_coordinator.py (prepare_handoff, execute_handoff with the shown signatures), and the package JSON shows the concrete data format. Minor gaps: 'project_dir' is undefined in the snippet, the 'from scripts.handoff_coordinator import' path relies on the scripts directory being a package (the script itself uses relative imports), and no example shows the target side loading a handoff (load_handoff is never mentioned).

4 / 5

Workflow Clarity

The source → coordinator → target sequence is clearly laid out, but validation checkpoints exist only as diagram labels ('Validate state consistency', 'Verify state') with no executable validation guidance in the body — and execute_handoff overwrites 'current.json', a state-mutating operation. The validation detail lives in the reference file, which the body signals only as 'Protocol details', so checkpoints are implicit. This matches anchor 3 rather than 4, where most checkpoints would be concretely present.

3 / 5

Progressive Disclosure

Structure is good — concise overview with clearly signaled one-level-deep references — but scored against the actual bundle, two of the six listed files are dead: 'references/AGENT-TRANSITIONS.md' and 'scripts/handoff_protocol.py' do not exist in the bundle. Broken navigation paths are more than the 'minor organization gaps' of anchor 4, though the overall structure and signaling exceed anchor 3's disorganized-content profile.

3 / 5

Total

13

/

20

Passed

Description

75%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 with an explicit 'Use when' clause and several concrete action triggers. The main weakness is the abstract headline 'Clean transitions between agents and sessions', which states a goal rather than the concrete capability (building handoff packages with serialized state).

DimensionReasoningScore

Specificity

The description lists several concrete actions — "preparing handoffs, serializing state, bridging context between agents, or coordinating multi-agent workflows" — matching the anchor for several specific actions with minor gaps. It falls short of 5 because the headline capability "Clean transitions between agents and sessions" is an abstract goal rather than a concrete capability statement (e.g., 'creates handoff packages'), and above 3 because more than 1-2 concrete actions are named.

4 / 5

Completeness

Both parts are present: the 'what' ("Clean transitions between agents and sessions") and an explicit 'when' ("Use when preparing handoffs, serializing state, bridging context between agents, or coordinating multi-agent workflows") with concrete trigger phrases. It is not 5 because the 'what' clause is abstract and does not state what the skill actually produces; it is not 3 because the 'when' is explicit and specific, not weakly implied.

4 / 5

Trigger Term Quality

Natural keywords like "handoffs", "agents", "sessions", "state", and "multi-agent workflows" give good coverage of what a user would say when needing this skill. It is not 5 because common variations are missing (e.g., 'context limit reached', 'continue where it left off', 'hand over work'), and not 3 because coverage goes beyond a single generic keyword.

4 / 5

Distinctiveness Conflict Risk

The handoff/context-bridging niche has distinct triggers and is mostly distinguishable from adjacent skills, with only minor overlap risk with closely related skills like context compaction or memory management. Not 5 because 'serializing state' and 'bridging context' could plausibly trigger session/memory-management skills.

4 / 5

Total

16

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

referenced_paths_exist

Referenced path issues: 2 missing

Warning

Total

14

/

16

Passed

Repository

fernandezbaptiste/Skrillz

Path

.claude/skills/handoff-coordinator/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.