CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

claude-handoff

把当前对话交接给一个全新的 background agent,让它立即接手工作。

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 ./skills/in-progress/claude-handoff/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

86%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 an exemplary lean instruction skill: a concrete copy-paste launch command, sharp per-instruction paragraphs, and thoughtful non-obvious rationale (shell quoting, display naming, secret stripping). The only gap is that the temp-file creation step and the command placeholders are never concretized into a fully worked example, and no verification of a successful launch is included.

DimensionReasoningScore

Conciseness

The ~15-line body is lean and assumes Claude's competence; every sentence instructs (write summary, save to temp dir, launch command, name it, include suggested skills, reference artifacts by path, strip secrets, honor arguments). The only rationale sentences — the shell-quoting pitfall for backticks/`$` and the `--name` display-name explanation — cover genuinely non-obvious pitfalls, so every token earns its place (anchor 5).

5 / 5

Actionability

The core command is concrete and executable — `claude --bg --name "<descriptive name>" -- "$(cat <summary file>)"` — with a worked example (`--name "Fix login bug"`) and specific instructions for summary content, matching anchor 4's 'mostly executable guidance with minor gaps'. It falls short of 5 because `<summary file>` and `<descriptive name>` remain unfilled placeholders with no concrete example of creating the temp file (e.g., a `mktemp`-style invocation or example path).

4 / 5

Workflow Clarity

The sequence — write handoff summary, save to temp dir, launch background agent, user manages via `claude agents` — is clear and unambiguous for a simple, non-destructive single-purpose skill, matching anchor 4. It is not 5 because there are no checkpoints at all (e.g., verifying the summary file was written or the agent actually launched), and not 3 because the single action is unambiguous and no validation-sensitive operation is involved.

4 / 5

Progressive Disclosure

The skill is under 50 lines, needs no external references, and is organized as one focused paragraph per instruction with no inlined material that belongs elsewhere. Per the simple-skill guidance, this earns anchor 5 on well-organized sections alone.

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 states a clear, concrete 'what' in a distinct niche, but is a single short sentence with no 'when to use' guidance and almost no trigger-term coverage. It reads as a minimal function signature rather than a discovery-oriented description. Adding trigger phrases and a 'Use when...' clause would lift it substantially.

Suggestions

Add an explicit 'Use when...' clause in the equivalent natural language, e.g. mention it should trigger when the user says 'handoff', '交接', 'continue this in a new session', or asks to hand work off to another agent.

Broaden trigger-term coverage with synonyms and phrasing users would actually say (handoff/hand off, continue work, take over, new session, background agent) so the skill is discoverable from varied phrasings.

Slightly expand the 'what' with 1-2 more concrete specifics (writes a handoff summary, launches a named background agent that picks up the work immediately) to move specificity from one action toward comprehensive coverage.

DimensionReasoningScore

Specificity

The description names one concrete action — "把当前对话交接给一个全新的 background agent,让它立即接手工作" (hand off the current conversation to a new background agent that immediately takes over) — matching anchor 3's '1-2 concrete actions, not comprehensive'. It stays at 3 rather than 4 because it lists only this single action with no detail on what the handoff involves (summary writing, temp file, background launch).

3 / 5

Completeness

The 'what' is clear (hand the current conversation to a new background agent), but the 'when' is entirely absent — there is no 'Use when...' clause or equivalent, which caps completeness at 3 per the judging guidelines. Not 2 because the 'what' is concrete, not vague.

3 / 5

Trigger Term Quality

"交接" (hand off) is a relevant, natural keyword a user might say, fitting anchor 3's 'some relevant keywords but missing common variations or synonyms' — synonyms like 'handoff', 'continue', 'spawn', or 'take over' are absent and no trigger phrasing is offered. It scores above 2 because the keyword is specific rather than generic like 'works with files'.

3 / 5

Distinctiveness Conflict Risk

Conversation handoff to a background agent is a distinct niche with little overlap risk against typical skills, fitting anchor 4's 'mostly distinct; minor overlap risk'. It falls short of 5 only because the description's terseness leaves it slightly ambiguous against generic agent-spawning or session-management skills.

4 / 5

Total

13

/

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

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository

vinvcn/mattpocock-skills-zh-CN

Path

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