CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

switch-worktree

Switch the current session to work in an existing git worktree

Quality

79%

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/switch-worktree/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

92%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, single-purpose skill: a clearly sequenced three-step workflow with genuine validation checkpoints (verify worktree exists, verify the cwd switch took effect) and stop-on-error guidance, with no padding or over-explanation. The only gap is that some steps read as templates with placeholders rather than fully copy-paste-ready commands.

DimensionReasoningScore

Conciseness

The ~45-line body explains nothing Claude already knows and every step earns its place ("Verify the worktree exists in `git worktree list` output. If not, stop with an error."). The only nit is the line "Switch the current session to an existing worktree." echoing the title, which does not drop it below anchor 5.

5 / 5

Actionability

Commands like `git worktree list`, `cd WORKTREE`, `pwd`, and `git branch --show-current` are concrete, but `WORKTREE`/`NAME` placeholders and the "Switched to worktree: WORKTREE" report block are templates rather than copy-paste-ready commands. This matches anchor 4 (mostly executable, minor gaps) rather than 5 (fully copy-paste ready).

4 / 5

Workflow Clarity

The sequence resolve -> verify exists -> cd -> verify cwd persisted -> report has explicit validation checkpoints at both risky points with stop-on-error handling ("If `pwd` does not show `WORKTREE`, stop with an error"). This is a simple, non-destructive skill, so the batch/destructive validation cap does not apply, and the simple-skill exception holds.

5 / 5

Progressive Disclosure

The skill is under 50 lines, needs no external references (none exist in references/scripts/assets), and is organized into clean 'Resolve / Switch cwd / Report' sections. Per the simple-skill guideline, well-organized sections alone merit anchor 5 here.

5 / 5

Total

19

/

20

Passed

Description

57%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 is concise, concrete, and clearly distinctive within the git-worktree niche, but it is a single bare capability statement. It lacks any trigger guidance ('use when...') and natural term variations, which caps completeness and trigger-term quality at the midpoint.

Suggestions

Add a 'Use when...' clause, e.g. 'Use when the user asks to switch to, enter, or work in an existing worktree.'

Include natural trigger variations and phrasing such as 'work tree', 'go to the worktree', or 'move to a worktree' to improve trigger term coverage.

Slightly expand the capability statement (e.g. mention it changes the session's working directory and reports the active branch) to lift specificity beyond one action.

DimensionReasoningScore

Specificity

"Switch the current session to work in an existing git worktree" names the domain and one concrete action but offers no secondary actions or scope detail. It matches anchor 3 (domain plus 1-2 concrete actions, not comprehensive) rather than 4, which requires several listed actions.

3 / 5

Completeness

The description clearly answers "what" (switch the current session to an existing worktree) but contains no "when to use" clause. Per the judging guidelines, a missing 'Use when...' or equivalent explicit trigger guidance caps completeness at 3.

3 / 5

Trigger Term Quality

"switch", "session", and "git worktree" are relevant natural terms, but common variations users might say ("work tree", "go to the worktree", "checkout a worktree") are absent because there is no trigger clause to supply them. Fits anchor 3 (some relevant keywords, missing variations/synonyms) more than 4.

3 / 5

Distinctiveness Conflict Risk

"git worktree" is a distinctive niche term unlikely to collide with other skills; the action is narrowly scoped to existing worktrees. It has a clear niche with minimal conflict risk, matching anchor 5.

5 / 5

Total

14

/

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

dlt-hub/dlt

Path

.claude/skills/switch-worktree/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.