CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

git-worktree-manager

Run parallel feature work safely with Git worktrees. Standardizes branch isolation, port allocation, environment sync, and cleanup so each worktree behaves like an independent local app. Optimized for multi-agent workflows where each agent or terminal session owns one worktree. Use when running multiple feature branches simultaneously, isolating experimental work, or coordinating multi-agent development across the same repo.

66

Quality

83%

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

73%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 well-structured, highly actionable skill body: executable commands, validated workflows with safety gates around destructive cleanup, and properly split one-level-deep references. The main costs are redundancy across the three overlapping checklist/pitfall sections and a broken README.md link in the References section.

Suggestions

Consolidate "Validation Checklist", "Operational Checklist", and the overlapping "Common Pitfalls"/"Best Practices"/"Failure Recovery" sections into a single checklist plus a short recovery section; ".worktree-ports.json" verification is repeated three times.

Remove the broken "[README.md](README.md)" link from the References section (no README.md exists in the bundle) or add the file.

Show the expected JSON schema for the `--input config.json` / stdin automation mode so the JSON example is executable end-to-end.

DimensionReasoningScore

Conciseness

The body never explains concepts Claude already knows (no 'what is a worktree' padding), but it is noticeably redundant across sections: "Validation Checklist", "Operational Checklist", "Common Pitfalls", "Best Practices", and "Failure Recovery" cover overlapping ground, and "Verify `.worktree-ports.json` exists" appears three separate times. This fits the 3 anchor (mostly efficient but could be tightened) rather than 4, since the overlap is more than minor trimming; it is not 2 because there is no filler or over-explanation of known concepts.

3 / 5

Actionability

Concrete, copy-paste-ready commands are given for both create and cleanup flows with full flags (e.g. `python scripts/worktree_manager.py --repo . --branch feature/new-auth --name wt-auth --base-branch main --install-deps --format text`), plus stdin/`--input` JSON modes and real script paths. It stops short of 5 because the JSON automation example is not executable end-to-end: the expected structure of `config.json` is never shown, and no example output (text or JSON) is displayed so results can't be verified against expectations.

4 / 5

Workflow Clarity

Create, parallel-session, and cleanup workflows are clearly sequenced, and the destructive cleanup path is well gated: "Detect stale worktrees and uncommitted changes before cleanup", "Remove only merged + clean worktrees, or force explicitly", and "Never force-remove dirty worktrees". The Validation and Operational checklists plus the Failure Recovery section (error -> corrective action, e.g. "If port allocation collides with external service: rerun with adjusted base ports") provide the explicit checkpoints and feedback loops of the 5 anchor, so the destructive-operation cap does not apply.

5 / 5

Progressive Disclosure

The body is a clear overview with well-signaled, one-level-deep references (docker-compose-patterns.md and port-allocation-strategy.md, both verified present in the bundle) linked at point of use and again in a References section, and detail is appropriately split out. It misses 5 because the References section links "[README.md](README.md) for quick start and installation details" and no README.md exists in the bundle, a broken navigation pointer; it stays above 3 because structure, signaling, and content split are otherwise solid.

4 / 5

Total

16

/

20

Passed

Description

87%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: concrete third-person capabilities, an explicit 'Use when...' trigger clause with natural phrasing, and a well-defined niche around Git worktrees and multi-agent branch isolation. The only weaknesses are minor missing trigger synonyms and a couple of high-level capability terms that could be more concrete.

DimensionReasoningScore

Specificity

"Standardizes branch isolation, port allocation, environment sync, and cleanup" names several concrete capability areas in third-person voice ("Run", "Standardizes"). It falls short of the 5 anchor because items like "environment sync" stay high-level rather than naming concrete operations, and "so each worktree behaves like an independent local app" is a soft benefit claim rather than an action; it is above 3 because four-plus specific capabilities are explicitly listed.

4 / 5

Completeness

The "what" is explicit (run parallel feature work with Git worktrees, standardizing branch isolation, port allocation, environment sync, and cleanup) and the "when" is an explicit trigger clause: "Use when running multiple feature branches simultaneously, isolating experimental work, or coordinating multi-agent development across the same repo." This clearly matches the 5 anchor: both what and when answered with concrete trigger phrases.

5 / 5

Trigger Term Quality

Natural phrases users would say are present: "Git worktrees", "running multiple feature branches simultaneously", "isolating experimental work", "coordinating multi-agent development". Coverage is good but misses common variations such as "work tree" (git's alternate spelling), "multiple terminals", or "two branches at once", placing it at 4 rather than the comprehensive synonym coverage of 5.

4 / 5

Distinctiveness Conflict Risk

"Git worktrees" plus "multi-agent workflows where each agent or terminal session owns one worktree" carves out a clear niche with distinct triggers; there is minimal risk this description would fire for an unrelated skill, matching the 5 anchor (clear niche with distinct triggers).

5 / 5

Total

18

/

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

relative_links

Relative link issues: 1 missing

Warning

Total

15

/

16

Passed

Repository

alirezarezvani/claude-skills

Path

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