CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

worktree

Use when you need workspace isolation for parallel tasks, risky changes, or multi-feature development without branch switching.

Quality

66%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/worktree/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

75%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 delivers a strong, executable worktree workflow with concrete git commands, dependency auto-detection, and an explicit verification checklist. Its main weakness is padding — an anti-rationalization table, an orchestrator diagram, and basic worktree-concept explanations that assume Claude needs convincing or education rather than instruction.

Suggestions

Delete the Anti-Rationalization table — it argues against hypothetical excuses rather than instructing, adding ~8 lines of non-operational content.

Compress Step 4 and the @orchestrator ASCII diagram to operational facts only (e.g., 'commits land on worktree/$ARGUMENTS'); Claude already knows worktrees are isolated repo copies.

DimensionReasoningScore

Conciseness

The command blocks are tight, but several sections pad or over-explain: the Anti-Rationalization table ('"I'll remember what I was working on" | "You won't."'), the @orchestrator ASCII diagram, and Step 4's explanation that 'The worktree is a full copy of the repo. Changes here do NOT affect the main worktree' — a concept Claude already knows. This matches 'mostly efficient but includes some unnecessary explanation or could be tightened'; not 2 because the core workflow, commands, and rules are lean and operational.

3 / 5

Actionability

Guidance is fully executable and copy-paste ready, covering all common cases: 'git worktree add .claude/worktrees/$ARGUMENTS -b worktree/$ARGUMENTS', a complete dependency auto-detect if/elif block (npm ci / yarn / pnpm / bun), and merge ('git merge worktree/$ARGUMENTS'), PR ('gh pr create'), discard, list, and prune variants. The only placeholders ($ARGUMENTS, /path/to/main/repo) are inherently context-dependent substitutions, not gaps.

5 / 5

Workflow Clarity

The 5-step workflow (select directory → create → setup → work → merge/discard) is clearly sequenced with an explicit Verification Protocol checklist ('git worktree list shows the new worktree', 'Tests pass in the worktree'), satisfying the destructive/batch validation requirement. It falls short of anchor 5 only because there is no error-recovery feedback loop — nothing instructs what to do when a verification check fails — matching 'clear sequence with most checkpoints present; minor validation gaps'.

4 / 5

Progressive Disclosure

The body is a well-organized single file with clear sections (When to Use, Workflow, Worktree Management, Verification Protocol, Rules) and no nested or buried references. At ~155 lines it exceeds the under-50-line simple-skill exception that would allow a 5, and marginal content like the orchestrator integration keeps it at 'good structure; most content is appropriately placed; minor organization gaps' rather than an optimally split overview.

4 / 5

Total

16

/

20

Passed

Description

43%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 provides a clear, explicit 'when' with natural use-case triggers, but it never states what the skill actually does — no action verbs and no mention of git worktrees — and uses second-person voice. It functions as a trigger while materially under-communicating the skill's capabilities.

Suggestions

Lead with a third-person statement of what the skill does, e.g., 'Creates, manages, and merges isolated git worktrees for parallel development.'

Add the primary trigger terms 'worktree', 'git worktree', and 'parallel agents' — users who know the concept will say 'worktree', not 'workspace isolation'.

Replace second-person phrasing ('when you need') with impersonal triggers ('Use when running parallel tasks or risky refactors...').

DimensionReasoningScore

Specificity

The description names the domain ("workspace isolation for parallel tasks, risky changes, or multi-feature development") but contains no concrete action verbs describing what the skill does, matching the score-2 anchor ('names the domain but actions are minimal or generic'); the second-person phrasing "when you need" incurs the rubric's mandated -1 voice penalty, yielding 1. It is not a pure anchor-1 fit ('entirely vague'), but the explicit penalty rule applies.

1 / 5

Completeness

The 'when' is explicit and concrete ("Use when you need workspace isolation for parallel tasks, risky changes, or multi-feature development"), but the 'what' is only implied — "workspace isolation" names a need, never an action the skill performs (no 'creates/manages/merges worktrees'). This sits between anchor 2 ('only when present without what') and anchor 3; the named isolation capability keeps it at 3 rather than 2, and the absence of any explicit 'what' prevents 4.

3 / 5

Trigger Term Quality

Phrases like "parallel tasks", "risky changes", and "without branch switching" are natural user language, but the description omits the single most likely trigger term — "worktree" / "git worktree" (the skill's own name) — plus synonyms like "parallel agents" or "work on multiple features", matching 'some relevant keywords but missing common variations or synonyms'. Not 4 because the missing primary term is the one users most likely would say.

3 / 5

Distinctiveness Conflict Risk

"workspace isolation" and "without branch switching" carve a clearly git-workflow-adjacent niche, matching 'mostly distinct; minor overlap risk with closely related skills'. Not 5 because the words 'git' or 'worktree' never appear, leaving some overlap risk with general parallelization, agent-orchestration, or container-isolation skills.

4 / 5

Total

11

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

14

/

16

Passed

Repository

fernandezbaptiste/specialist-agent

Path

skills/worktree/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.