x-worktree

Use when the user (or a sibling skill via --wt flag) wants to spin up an isolated git worktree for a task — wraps the worktrunk `wt` CLI when present, falls back to native `git worktree`, switches the Bash session cwd into the new worktree, auto-applies docker isolation when profile present (skip with --no-isolate), and emits a machine-readable result envelope

Quality

92%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No known issues

Quality

Content

85%

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

The body is highly actionable and workflow-clear with strong validation/rollback loops and a clean one-level reference structure; the only weakness is moderate verbosity where the branch-naming table and Gotchas partially restate earlier material.

Suggestions

Collapse the 'Always-create-new-branch (by design)' table, which duplicates the Invocation table's 0/1/2-arg rows — keep only the non-redundant note about never switching into an existing branch.

Trim the Gotchas list by merging low-likelihood entries (symlinks/non-standard layouts, submodule init) into the relevant step text rather than a standalone section, to reduce token cost.

Dimension	Reasoning	Score
Conciseness	The body assumes Claude's competence (no git/worktree primers) and most detail is load-bearing operational spec, but the 'Always-create-new-branch (by design)' table re-states the Invocation table and the long Gotchas list could be tightened, fitting the level-2 mostly-efficient-but-could-be-tightened anchor rather than the fully lean level-3.	2 / 3
Actionability	Concrete, copy-paste-ready commands and bash blocks appear throughout — git worktree add -b with the new branch/path/base args, wt switch --create --base, openssl rand -hex 3, and full migration/isolation code — matching the level-3 fully-executable/copy-paste-ready anchor and exceeding the pseudocode level-2 case.	3 / 3
Workflow Clarity	Steps 0–8 are explicitly sequenced with validation checkpoints (env check then STOP, detached-HEAD check, doc-state validation with STOP, git check-ref-format) and feedback loops (rollback of file moves on commit failure, orphan cleanup on isolate failure), matching the level-3 anchor including error-recovery loops for destructive/batch operations.	3 / 3
Progressive Disclosure	SKILL.md is an overview with well-signaled, one-level-deep references — references/doc-naming.md, examples.md, caller-integration.md, auto-isolation.md, anti-patterns.md — each summarized with a 'See X for:' line, and all five referenced files exist in ./references/, fitting the level-3 clear-overview-with-well-signaled-one-level-deep-references anchor.	3 / 3
	Total	11 / 12 Passed

Description

100%

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 specific, uses an explicit 'Use when' trigger, covers both what and when, and occupies a clear niche with no realistic conflict risk. Voice is third person throughout, so no person-penalty applies.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions — spin up an isolated git worktree, wrap the worktrunk wt CLI when present with a native git worktree fallback, switch the Bash session cwd, auto-apply docker isolation, emit a machine-readable result envelope — matching the level-3 anchor of several specific concrete actions.	3 / 3
Completeness	It opens with an explicit 'Use when the user ... wants to spin up an isolated git worktree for a task' trigger and then states what it does, clearly answering both what and when; not the level-2 case where 'when' is only implied.	3 / 3
Trigger Term Quality	Natural user-facing terms are well covered (isolated git worktree, worktree for a task) which a user would actually say; the wt/--no-isolate/--wt jargon augments rather than replaces those natural triggers, so it is not the level-2 missing-common-variations case.	3 / 3
Distinctiveness Conflict Risk	The niche is sharply defined — isolated worktree provisioning with cwd switching, docker auto-isolation, and a machine-readable envelope — making overlap with other skills unlikely; it is far more specific than the level-2 'Works with document files' anchor.	3 / 3
	Total	12 / 12 Passed

Validation

93%

Warnings & errors only

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

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	15 / 16 Passed

Repository: quangtran88/x-skills
Path: skills/x-worktree/SKILL.md
Commit: c765280

Reviewed: 13 days ago

Table of Contents

Discovery Implementation Validation

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.