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

84%

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

The canonical home for this skill is using-git-worktrees in phatblat/dotfiles

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.

The body is a generated delegation stub: maximally concise, with one unambiguous, executable instruction. However, it delegates all substantive content to an external absolute path outside the skill's bundle, which does not resolve here, leaving the skill with no in-bundle materials and a single point of failure for navigation.

Suggestions

Ship the shared skill content as a bundle-relative reference (e.g. references/worktree-convention.md) or vendor a copy inside the skill directory so the SKILL.md reference resolves within the bundle itself.

Add a one-line fallback for when '~/.agents/skills/using-git-worktrees/SKILL.md' is absent (e.g. 'If missing, ask the user where the shared skills directory lives') so the redirect is not a dead end.

State what 'follow' concretely means (read the file and apply it as this skill's instructions) so harnesses that cannot auto-load external paths still know the exact next step.

DimensionReasoningScore

Conciseness

The body is two lean lines — 'Load and follow the shared skill at `~/.agents/skills/using-git-worktrees/SKILL.md`' plus a generator comment — with zero padding and no explanation of concepts Claude already knows. Every token earns its place.

5 / 5

Actionability

'Load and follow the shared skill at `~/.agents/skills/using-git-worktrees/SKILL.md`' is a concrete, executable directive with an exact path, so an agent knows precisely what to do. Not 5 because it covers only the single redirect case with no fallback guidance if the target file is absent; not 3 because the instruction as written is complete and specific rather than missing key details.

4 / 5

Workflow Clarity

A single unambiguous action (load and follow the shared skill), which the simple-skill exception says can score 5. No destructive or batch operations are described in the body, so the validation cap does not apply.

5 / 5

Progressive Disclosure

The bundle contains no reference/asset/script files, and the sole referenced path is an absolute home-directory path ('~/.agents/skills/using-git-worktrees/SKILL.md') that does not resolve in this environment, so navigation cannot be verified against a real file. The reference is clearly signaled but points entirely outside the skill's own structure with an empty bundle — structure exists but organization is questionable, fitting anchor 3 rather than 4's 'only minor organization gaps'.

3 / 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 description: it names concrete specifics (path convention, dotfiles-repo opt-in, validation limits), provides an explicit use clause, and cleanly distinguishes itself from the sibling git-worktree skill. The main limitation is that trigger phrases are somewhat abstract ('understand or explain') and lack common user variations.

DimensionReasoningScore

Specificity

Names the domain plus several concrete items — 'the ~/.worktrees/<path-key>/<branch> worktree convention, the dotfiles-repo opt-in, and what a dotfiles worktree cannot validate' — including a concrete path pattern. Not 5 because coverage is not comprehensive (operations like cleanup/switching are only implicitly delegated); not 3 because it lists three-plus specific items rather than 1-2.

4 / 5

Completeness

Both parts are explicit: the 'what' ('Explains the ~/.worktrees/<path-key>/<branch> worktree convention, the dotfiles-repo opt-in, and what a dotfiles worktree cannot validate') and the 'when' ('Use to understand or explain worktree layout and its constraints'). Not 5 because the trigger phrasing is abstract ('understand or explain') rather than concrete user-mention triggers; not 3 because the 'when' is explicitly stated, not missing or weakly implied.

4 / 5

Trigger Term Quality

Natural terms are present ('worktree convention', 'worktree layout', 'constraints', 'git-worktree skill'), which users would plausibly say when needing this skill. Not 5 because common variations like 'parallel branches', 'multiple working trees', or 'git worktree add' are missing; not 3 because coverage goes beyond a couple of generic keywords.

4 / 5

Distinctiveness Conflict Risk

It actively de-conflicts against the closest related skill — 'use the git-worktree skill to actually create, switch to, or delete one' — carving a clear explain-the-convention vs. operate-on-worktrees niche. Minimal conflict risk; this matches the clear-niche anchor better than the minor-overlap anchor at 4.

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

.claude/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.