CtrlK
BlogDocsLog inGet started
Tessl Logo

worktrail-handoff

Capture a discovered problem, gap, tech debt, or deferred work into a local work queue so a future agent session can pick it up cold. Use mid-session whenever you set work aside instead of doing it now — a fix you judge out of scope for this PR, work that belongs in a follow-up or a separate/later PR, an item you're deferring, or something worth fixing you won't tackle now — so the outstanding item isn't lost without derailing current work; can be called multiple times per session. Trigger phrases: "defer this", "item deferred", "out of scope for this PR", "follow-up work", "leave for another PR", "capture for later", "outstanding item". This skill captures only. Picking a brief back up is the front door's job: worktrail-go <brief-id>.

71

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

81%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 strong operational skill body: copy-paste-ready CLI workflows with explicit validation branches, clear step sequencing, and an appropriately split reference file. The main weakness is conciseness — rationale sentences and a dated incident anecdote inflate the token budget without adding executable guidance, and some front-door-owned detail is inlined.

Suggestions

Cut the rationale narration to single clauses — e.g. drop "a second documented path is how the queue ended up with two half-true answers to 'how do I start this brief?'" and keep only the rule ("Send the user to worktrail-go; do not document a claim procedure here").

Replace the dated incident (brief 20260817-101013 closed 2026-08-20 with 'disproven...') with the undated rule plus a one-line justification, or move the full incident into references/handoff-template.md as a worked example of a rejected closure note.

Compress the 'Proactive session-end quality gate' prose into a short checklist (qualifies: new capability / removed bottleneck / material user outcome / verified major risk; otherwise skip capture) to trim ~10 lines without losing the gate.

DimensionReasoningScore

Conciseness

The body is almost entirely operational (commands, flags, branch handling) with no concept-teaching padding, but it carries unnecessary rationale narration ("a second documented path is how the queue ended up with two half-true answers to 'how do I start this brief?'") and a time-sensitive dated incident ("brief 20260817-101013-... was closed 2026-08-20 with 'disproven...'") embedded mid-body, which the guidelines penalize and which could be cut to a one-line rule. Not 2: there is no explanation of things Claude already knows; not 4: several sentences of justification and the anecdote are trimmable.

3 / 5

Actionability

Fully executable command templates with complete flag lists and return-value contracts — worktrail-check-duplicate-brief, worktrail-handoff, worktrail-work-queue link/triage, worktrail-decision list/show/answer — plus edge-case branches (match/null/headless) and failure handling ("If creation fails, report the CLI error and do not hand-write a fallback document"). Optional flags are explicitly justified rather than pseudocode.

5 / 5

Workflow Clarity

The capture workflow is explicitly sequenced (Step 1 → Step 1.5 pre-write duplicate check → Step 2 create → Step 3 confirm) with an explicit validation checkpoint, decision branches for each check outcome, an ask-then-link confirm-candidate loop, and error-recovery guidance. Checkpoints are explicit, matching the top anchor rather than the anchor-4 'most checkpoints' case.

5 / 5

Progressive Disclosure

Good structure: field rules and the full example are correctly split into the one-level-deep, clearly signaled references/handoff-template.md (verified present in the bundle), and the body summarizes only what matters. Not 5: the body inlines detail owned by the front-door skill per its own admission ("Closure runs through the front door, which owns..." yet the re-verification rules and decision commands are documented at length here), a minor placement gap.

4 / 5

Total

17

/

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.

Excellent description: concrete single-action capability, comprehensive natural trigger phrases, explicit what/when, and a deliberate boundary that disambiguates it from the companion pickup skill. Its only limitation is inherent to the skill being single-action, not a flaw in the writing.

DimensionReasoningScore

Specificity

"Capture a discovered problem, gap, tech debt, or deferred work into a local work queue so a future agent session can pick it up cold" names the domain and core action concretely, with an explicit boundary ("This skill captures only. Picking a brief back up is the front door's job"). Not 3: coverage of the skill's single action is complete rather than partial; not 5: it lists one core action with rich context rather than multiple distinct concrete actions.

4 / 5

Completeness

Both "what" (capture deferred work into a local queue so a future session can pick it up cold) and "when" ("Use mid-session whenever you set work aside instead of doing it now — a fix you judge out of scope for this PR, work that belongs in a follow-up...") are explicitly answered with concrete trigger phrases. Not 4: nothing about the when-clause is implicit or underspecified.

5 / 5

Trigger Term Quality

Explicit trigger phrases — "defer this", "item deferred", "out of scope for this PR", "follow-up work", "leave for another PR", "capture for later", "outstanding item" — give comprehensive coverage of natural user phrasing with synonyms, matching the top anchor. A user setting work aside would naturally say nearly all of these.

5 / 5

Distinctiveness Conflict Risk

The explicit negative boundary ("This skill captures only. Picking a brief back up is the front door's job: worktrail-go <brief-id>") plus capture-specific trigger phrases carve a clear niche with minimal risk of firing for the sibling pickup skill.

5 / 5

Total

19

/

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

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

frontmatter_unknown_keys

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

Warning

Total

14

/

16

Passed

Repository
behindthedash/worktrail
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.