CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

using-git-worktrees

Explains the ~/.worktrees/<path-key>/<branch> worktree convention, the dotfiles-repo opt-in, and what a dotfiles worktree cannot validate. Use to understand or explain worktree layout and its constraints; use the git-worktree skill to actually create, switch to, or delete one.

Quality

82%

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

78%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 tight, well-structured reference skill: high signal density, concrete commands, situation-to-action tables, and explicit safety constraints. The main improvements are sequencing the home-deployment flow with validation checkpoints and trimming the few remaining asides.

Suggestions

Sequence the live-$HOME promotion flow explicitly (merge/check out in ~/dev/dotfiles -> just home-deploy <ref> -> just home-live) with a verification step such as confirming deployed symlinks.

Provide path-key derivation as a ready-to-run command (e.g. a git rev-parse + tr pipeline) instead of only a prose rule.

Trim the announce-at-start line and long parentheticals like the bin/vi neovim dispatch note to reclaim tokens.

DimensionReasoningScore

Conciseness

The body is dense and environment-specific (path keys, mise dot deployment, hook behavior) and assumes git competence without re-explanding basics, so nearly every token earns its place. It is not a 5 because of minor trims available: the announce-at-start line and several long parenthetical asides (e.g. the bin/vi dispatch explanation).

4 / 5

Actionability

Guidance is concrete and copy-paste ready in the key places: "git rev-parse --path-format=absolute --git-common-dir", "just home-deploy <ref>", "just home-live", "wt shell <branch>", plus an explicit path-key rule and worked table examples. Not 5 because path-key computation is described but not given as a command, and the core create/switch/delete procedure is delegated to another skill.

4 / 5

Workflow Clarity

The Quick Reference situation-to-action table and the Never list act as clear decision checkpoints, and the detection step ("Resolve via git rev-parse ... not --show-toplevel") is an explicit verification method with rationale. Not 5 because the "promote changes to live $HOME" flow (merge/checkout, home-deploy, home-live) is described but not sequenced with validation checkpoints.

4 / 5

Progressive Disclosure

This is a single-purpose skill with no bundle files; the ~60-line body is well-organized into clearly headed sections (Core Convention, Dotfiles Repo, Quick Reference, Never, Integration) with no content that belongs in a separate file. The only pointers are clearly signaled cross-skill references (git-worktree, branch-finish) and repo-internal spec paths, all one level deep.

5 / 5

Total

17

/

20

Passed

Description

78%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, specific description in third person that clearly separates this explanatory skill from the executable git-worktree skill. Its main gaps are the absence of concrete trigger phrases in the 'Use to...' clause and a slight internal inconsistency ("dotfiles-repo opt-in" vs. the body's "no --allow-home opt-in").

Suggestions

Add concrete trigger phrases to the 'when' clause, e.g. "Use when the user asks where worktrees live, why a worktree isn't under .worktrees/, or what a dotfiles worktree can and cannot test."

Include natural keyword variants such as "git worktree" or "parallel branch checkouts" to broaden trigger coverage.

Fix the description/body mismatch: the description says "dotfiles-repo opt-in" while the body states there is no opt-in for the dotfiles repo.

DimensionReasoningScore

Specificity

The description names the domain and three concrete topics with a literal path pattern ("Explains the ~/.worktrees/<path-key>/<branch> worktree convention, the dotfiles-repo opt-in, and what a dotfiles worktree cannot validate"), which lists several specific items with minor gaps. It is not a 5 because it does not enumerate what the constraints or coverage actually are.

4 / 5

Completeness

Both halves are present: the what ("Explains the ~/.worktrees/<path-key>/<branch> worktree convention... what a dotfiles worktree cannot validate") and an explicit when ("Use to understand or explain worktree layout and its constraints"). Not 5 because the 'when' clause lacks concrete user-side trigger phrases; not 3 because an explicit 'Use to...' clause exists and routing to the sibling skill is stated.

4 / 5

Trigger Term Quality

"worktree" recurs in several natural phrasings ("worktree convention", "worktree layout", "dotfiles worktree", "git-worktree skill") that users would plausibly say. It falls short of 5 because common variations like "git worktree", "parallel branches", or "multiple checkouts" are absent.

4 / 5

Distinctiveness Conflict Risk

It carves out a clear niche (layout and constraints, not execution) and explicitly disambiguates from the closest competing skill: "use the git-worktree skill to actually create, switch to, or delete one." This gives it distinct triggers with minimal conflict risk.

5 / 5

Total

17

/

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

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

15

/

16

Passed

Repository

phatblat/dotfiles

Path

.agents/skills/using-git-worktrees/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.