CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

wt-switch-create

Create a new worktrunk worktree (optionally in another repo) and switch this session's working directory into it. Use when launching a session that should work in its own worktree.

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

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.

An impressively rigorous operational skill: exact commands, tool call syntax, and exhaustive error-recovery decision trees make it fully actionable with strong workflow clarity. The weaknesses are a dangling reference to a nonexistent rationale.md and heavy inline conditional detail that would benefit from progressive disclosure into a reference file.

Suggestions

The maintainer comment references "rationale.md (same directory)" but no such file exists in the bundle — either add that file or remove the pointer so the reference is not dangling.

Move the step-3 recovery branches (agent-pinned, unreachable worktree, denied entry) into a references/recovery.md and keep only the main path plus a clearly signaled one-level-deep pointer inline, reducing SKILL.md's inline load.

Trim justification clauses to the operative instruction where the why is not needed for the decision, e.g. reduce the CLAUDE.md/AGENTS.md loading explanation to just the instruction to read the new repo's root files.

DimensionReasoningScore

Conciseness

The body is dense and operational with no padding about concepts Claude already knows, but contains minor instances of over-explanation that could be trimmed, e.g. "Claude Code keeps the launch repo's root instructions in context and loads only the new repo's nested ones, so the new repo's root files supersede the launch repo's for the rest of the session" where the operative instruction (read the new repo's root CLAUDE.md/AGENTS.md) would suffice, and the extended bare-name disambiguation prose. This matches the efficient-with-minor-trims anchor, not the lean every-token-earns-its-place anchor.

4 / 5

Actionability

Fully executable guidance throughout: exact tool invocations ("EnterWorktree({name: \"<branch>\"})", "ExitWorktree({action: \"keep\"})"), a copy-paste-ready command ("wt -C <repo> switch --create <branch> --no-cd --format=json") with parsing instructions for its JSON output, concrete git stash commands, and four usage examples covering the common cases. Matches the fully-executable anchor.

5 / 5

Workflow Clarity

A clear numbered sequence (pick branch, create-and-enter, wt-plus-enter-by-path) with explicit validation checkpoints and feedback loops: branch-exists error triggers a defined rerun, the step-3 failure mode names its error string, and EnterWorktree outcomes (Accepted / Tool error / Denied) each branch into concrete recovery steps with a testable check ("cd <path>" and look for "Shell cwd was reset"). Matches the explicit-validation-with-recovery anchor; no destructive/batch cap applies since worktree creation is non-destructive and removal is explicitly guarded ("Don't remove it unprompted").

5 / 5

Progressive Disclosure

Sections are well-organized for a single-file skill, but the only referenced path is a maintainer comment pointing to "rationale.md (same directory)", which does not exist in the bundle, and ~150 lines of inline conditional detail (argument disambiguation rules, mid-session stash carry, recovery branches for pinned/unreachable/denied entry) are content that could live in a separate reference. This sits between the some-structure and good-structure anchors: better organized than minimal, but the dangling reference and unsplit inline detail keep it below a 4.

3 / 5

Total

17

/

20

Passed

Description

87%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 strong description: third-person, concrete, and scoped, with an explicit "Use when" trigger clause and a distinctive niche vocabulary. Only minor improvements available in trigger-term variants and coverage of the run-task-inside-worktree behavior.

DimensionReasoningScore

Specificity

"Create a new worktrunk worktree (optionally in another repo) and switch this session's working directory into it" lists several concrete actions (create, target another repo, switch session cwd), matching the anchor for specific actions with minor gaps. It is not a 5 because coverage is incomplete (no mention of running a task inside the worktree or of the branch-name argument), and not a 3 because it goes beyond 1-2 actions.

4 / 5

Completeness

It clearly answers both: the what ("Create a new worktrunk worktree (optionally in another repo) and switch this session's working directory into it") and an explicit when with a concrete trigger phrase ("Use when launching a session that should work in its own worktree"), matching the anchor that requires both with concrete triggers.

5 / 5

Trigger Term Quality

Natural terms "worktrunk worktree", "worktree", "session", and "own worktree" give good keyword coverage for this niche, matching the good-coverage anchor. A few natural variants users might say ("isolate this session", "git worktree", "new branch checkout") are missing, keeping it below comprehensive coverage.

4 / 5

Distinctiveness Conflict Risk

"worktrunk worktree" plus session-cwd switching defines a clear niche with distinct triggers; no plausible overlap with other skills, matching the minimal-conflict-risk anchor.

5 / 5

Total

18

/

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

max-sixty/worktrunk

Path

skills/wt-switch-create/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.