CtrlK
BlogDocsLog inGet started
Tessl Logo

handoff

Use when capturing session state before switching context, ending a session, or manually preserving progress — creates a structured handoff document in docs/handoffs/ so a future session can resume seamlessly

68

Quality

83%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Quality

Content

77%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a well-structured, highly actionable skill with a clear 5-step workflow and a complete, copy-paste-ready template. Its main weakness is moderate verbosity — the Cross-Agent Handoff section over-explains why plain markdown files are portable, and some contextual sections could be trimmed. The progressive disclosure is adequate but could benefit from splitting supplementary content into separate files.

Suggestions

Trim the 'Cross-Agent Handoff' section significantly — the use case list and 'Why this works' paragraph explain something Claude can infer from the template being a markdown file. A single sentence noting cross-agent compatibility would suffice.

Consider moving the 'Automatic Compaction Handoff' section to a separate reference file, as it describes hook behavior rather than the manual skill workflow.

DimensionReasoningScore

Conciseness

The skill is mostly efficient but includes some sections that could be tightened. The 'Cross-Agent Handoff' section with its extensive use cases and the 'Why this works' explanation are somewhat verbose — Claude can infer cross-agent compatibility from the fact that it's a markdown file. The 'When to Use' / 'Don't use when' section and the 'Automatic Compaction Handoff' section add useful but slightly padded context.

2 / 3

Actionability

The skill provides fully concrete, executable guidance: specific bash commands for gathering state, an exact markdown template with frontmatter, clear topic slug guidelines with good/bad examples, and a specific output path pattern. Every step tells Claude exactly what to do and produce.

3 / 3

Workflow Clarity

The 5-step process is clearly sequenced with explicit actions at each stage. Step 1 gathers mechanical state, Step 2 generates the topic, Step 3 writes the document using a complete template, Step 4 fills all sections with specific guidance per section, and Step 5 confirms with a structured summary. The workflow is linear and unambiguous with no destructive operations requiring validation loops.

3 / 3

Progressive Disclosure

The skill references companion skills (handoff-resume, handoff-list, compound, finishing-a-development-branch) and mentions hook scripts, but all content is inline in a single file. The Cross-Agent Handoff section and Automatic Compaction Handoff section could be split into separate reference documents, as they're supplementary to the core workflow. However, no bundle files exist to evaluate against.

2 / 3

Total

10

/

12

Passed

Description

89%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This is a well-constructed description that clearly communicates when to use the skill and what it produces. The 'Use when' clause is explicit and covers multiple trigger scenarios. The main weakness is that it could be more specific about what concrete information is captured in the handoff document.

Suggestions

Add more specific concrete actions describing what the handoff document contains, e.g., 'captures open tasks, decisions made, pending questions, and file context into a structured handoff document'

DimensionReasoningScore

Specificity

It names the domain (session state/handoff) and describes the core action (creates a structured handoff document in docs/handoffs/), but doesn't list multiple specific concrete actions beyond that single output. It mentions capturing session state but doesn't detail what is captured (e.g., open tasks, decisions made, pending items).

2 / 3

Completeness

Clearly answers both what ('creates a structured handoff document in docs/handoffs/') and when ('when capturing session state before switching context, ending a session, or manually preserving progress'). The 'Use when' clause is explicit and upfront.

3 / 3

Trigger Term Quality

Includes strong natural trigger terms: 'session state', 'switching context', 'ending a session', 'preserving progress', 'handoff', 'resume'. These are terms a user would naturally say when needing this functionality.

3 / 3

Distinctiveness Conflict Risk

This is a very specific niche — session handoff/context preservation with a specific output location (docs/handoffs/). It's unlikely to conflict with other skills since the concept of session state handoff documents is quite distinct.

3 / 3

Total

11

/

12

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
lucianghinda/superpowers-ruby
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.