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

SKILL.md
Quality
Evals
Security

Quality

Content

71%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 redirect stub: maximally lean, but its only instruction points to a shared skill that is not present in the bundle or on the filesystem, so the skill carries no usable content of its own. Structure is trivially simple rather than well-organized progressive disclosure — the entire content lives one unresolvable hop away.

Suggestions

Inline a minimal summary of the worktree convention (the ~/.worktrees/<path-key>/<branch> layout, the dotfiles-repo opt-in, and known limitations) directly in SKILL.md, or ship the shared content as a bundle file under references/ so the skill remains usable when the external path is absent.

Make the referenced path verifiable — either relative to the skill bundle or accompanied by a fallback note explaining what to do if ~/.agents/skills/using-git-worktrees/SKILL.md is unavailable.

Remove or contextualize the "Generated by scripts/agent-harnesses.py; do not edit directly" comment, since no such script ships with this bundle and it adds a dangling reference for readers.

DimensionReasoningScore

Conciseness

The body is two lines — a provenance comment and a single pointer instruction — with no padding, no explanation of concepts Claude already knows, and nothing to trim. Every token earns its place, matching the lean-and-efficient anchor exactly.

5 / 5

Actionability

The one instruction is concrete ("Load and follow the shared skill at ~/.agents/skills/using-git-worktrees/SKILL.md"), but the referenced file does not exist — neither in the bundle (no references/, scripts/, or assets/ directories) nor on disk — so executing the load step dead-ends. There is no inlined guidance and no fallback, leaving the guidance concrete but incomplete; it is below the 4 anchor's 'minor gaps' and above the vague/abstract anchors.

3 / 5

Workflow Clarity

The single action is unambiguous (load a specific file, then follow it), which under the simple-skill note could score 5 — but there is no checkpoint or fallback for the case where the referenced shared skill is unresolvable, which is a real gap here. It fits the 4 anchor: clear sequence with a minor gap.

4 / 5

Progressive Disclosure

The single reference is clearly signaled and one level deep, but it points outside the bundle to a file that is absent, and the body's "Generated by scripts/agent-harnesses.py" mentions a script that is not in the bundle either. With zero overview content inlined, the SKILL.md is an empty shell whose one hop leads nowhere — matching the 'some structure but references unresolvable / could be better organized' band more than the 4 anchor's 'minor organization gaps'.

3 / 5

Total

15

/

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.

The description is strong: specific, third-person, and comprehensive about both what the skill covers and when to use it, with an unusually good explicit boundary against the sibling git-worktree skill. The only minor gap is missing a few natural trigger variations such as "working tree" or "parallel checkout".

DimensionReasoningScore

Specificity

The description lists multiple concrete capabilities with exact detail: "Explains the ~/.worktrees/<path-key>/<branch> worktree convention, the dotfiles-repo opt-in, and what a dotfiles worktree cannot validate" — including the literal path pattern. Coverage is comprehensive for its explanatory scope (convention, opt-in, limitations, and explicit delegation of create/switch/delete), so it exceeds the 'several specific actions with minor gaps' anchor.

5 / 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"), plus an explicit anti-trigger delegating actions to the git-worktree skill. It clearly matches the both-what-and-when-with-concrete-triggers anchor rather than the 4 anchor where 'when' could be more explicit.

5 / 5

Trigger Term Quality

Good natural keyword coverage: "worktree convention", "worktree layout", "dotfiles-repo", "create, switch to, or delete" — phrases a user would plausibly say. It misses common variations such as "working tree", "parallel checkout", or "multiple branches at once", so it falls just short of the comprehensive-synonyms anchor at 5.

4 / 5

Distinctiveness Conflict Risk

"use the git-worktree skill to actually create, switch to, or delete one" explicitly disambiguates this explanatory skill from its sibling action skill, carving out a clear niche with minimal conflict risk — the strongest fit to the 'clear niche with distinct triggers' anchor.

5 / 5

Total

19

/

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/harness/adapters/antigravity/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.