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 findings from the security scan

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.

A thorough, highly actionable multi-step procedure with excellent sequencing, validation, and feedback loops, plus clean progressive disclosure into real reference files. The only weakness is minor inline over-explanation in a few rationale paragraphs that could be tightened for token efficiency.

Suggestions

Trim the inline 'Reasoning:' paragraphs (e.g. Step 6.5 stderr-sanitization rationale, mktemp symlink-attack justification) into one-line notes or move them into references/auto-isolation.md to reduce token load.

Condense the 'Who acts on the suggestion' paragraph in Step 8 into a compact table or two-line rule, since the distinction is the only essential payload.

Consider moving the 'Gotchas' list into references/anti-patterns.md (already referenced) to keep the body a pure overview+procedure.

Dimension	Reasoning	Score
Conciseness	Mostly dense, executable procedure with no padding about concepts Claude already knows, but several inline 'Reasoning:' notes (e.g. the stderr-sanitization rationale, symlink-attack justification, 'Who acts on the suggestion' paragraph) could be trimmed; efficient with minor over-explanation.	4 / 5
Actionability	Fully executable throughout — exact bash commands, mktemp/timeout invocations, git check-ref-format validation, copy-paste-ready envelope templates, and concrete error-recovery commands cover the common and failure cases.	5 / 5
Workflow Clarity	Steps 0–8 are explicitly sequenced with validation checkpoints at every risky point (is-inside-work-tree, detached-HEAD, doc-state checks, check-ref-format), plus feedback loops (rollback on migration failure, orphan cleanup, retry hints) appropriate for this batch/destructive operation.	5 / 5
Progressive Disclosure	Clear overview body with well-signaled one-level-deep references — each 'See references/<file>.md for: <content list>' points to a real file (doc-naming, auto-isolation, caller-integration, examples, anti-patterns), with bulk detail appropriately split out and easy to navigate.	5 / 5
	Total	19 / 20 Passed

Description

92%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 highly specific, third-person description that clearly states both what the skill does and when to use it, with concrete trigger phrasing and minimal conflict risk. The only minor gap is trigger-term synonym breadth, which keeps it just short of perfect on that one dimension.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions — 'spin up an isolated git worktree', 'wraps the worktrunk wt CLI when present, falls back to native git worktree', 'switches the Bash session cwd', 'auto-applies docker isolation', 'emits a machine-readable result envelope' — giving comprehensive coverage of capabilities.	5 / 5
Completeness	Explicitly answers both 'what' (the enumerated provisioning/isolation/envelope actions) and 'when' via the concrete 'Use when the user (or a sibling skill via --wt flag) wants to spin up an isolated git worktree for a task' trigger phrase.	5 / 5
Trigger Term Quality	Strong natural keywords ('isolated git worktree', 'worktree', '--wt flag', 'docker isolation') that users would actually say, but missing common synonyms like 'checkout'/'branch' and any file-extension equivalents; not quite the full synonym coverage of a 5.	4 / 5
Distinctiveness Conflict Risk	Occupies a clear niche (isolated worktree provisioner with auto-isolation) with a distinct trigger unlikely to fire for unrelated skills; the worktree+isolation framing minimizes conflict risk.	5 / 5
	Total	19 / 20 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: f17a69e

Reviewed: 6 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.