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.

71

Quality

89%

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 git-worktree-manager in alirezarezvani/claude-skills

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.

A well-structured operational skill with executable commands, sequenced workflows, strong validation checkpoints, and explicit recovery guidance for destructive operations. Its main defects are broken bundle references (referenced files and scripts are absent) and some redundancy between the Overview and checklist sections.

Suggestions

Include the referenced files in the bundle (references/port-allocation-strategy.md, references/docker-compose-patterns.md, scripts/worktree_manager.py, scripts/worktree_cleanup.py, README.md) or inline their essential content so the one-level-deep reference structure actually resolves.

Merge the Validation Checklist with the Operational Checklist's After Creation section to remove overlapping verification items and tighten the body.

Drop the Overview paragraph that restates the frontmatter description verbatim and keep only the multi-agent ownership note that adds new information.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence — no tutorial explanation of what worktrees are — with every section carrying operational content. It could be tightened: the Overview repeats the frontmatter description nearly verbatim, and the Validation Checklist overlaps the Operational Checklist's After Creation items. Efficient with minor trimmable redundancy, matching the 4 anchor rather than the fully lean 5.

4 / 5

Actionability

Commands are copy-paste ready and complete, e.g. 'python scripts/worktree_manager.py --repo . --branch feature/new-auth --name wt-auth --base-branch main --install-deps --format text' and both stdin and '--input file' JSON variants, plus concrete cleanup invocations with flags. Specific examples cover the creation, parallel-run, and cleanup cases.

5 / 5

Workflow Clarity

Multi-step workflows are numbered and paired with explicit validation checkpoints ('Validation Checklist', 'Before Creation / After Creation / Before Removal') and a Failure Recovery section giving feedback loops (e.g. 'If port allocation collides with external service: rerun with adjusted base ports'). The destructive cleanup workflow is guarded by dirty-state and merged-branch checks with a 'remove only merged + clean' rule and a never-force-dirty caveat, so the destructive-operation cap does not apply.

5 / 5

Progressive Disclosure

References are clearly signaled and one level deep ('See [port-allocation-strategy.md](references/port-allocation-strategy.md) for the full strategy and edge cases'), but none of the referenced files — references/*.md, scripts/worktree_manager.py, scripts/worktree_cleanup.py, or README.md — exist in the bundle, so the promised navigation is broken. Not 4, because the split depends on files that are missing; not 2, because the in-body structure and reference signaling are genuinely good.

3 / 5

Total

17

/

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.

A strong description: concrete third-person capability statement paired with an explicit, well-scoped 'Use when' clause covering parallel branches, experimental isolation, and multi-agent coordination. The only gap is modest synonym coverage in trigger terms.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — 'Run parallel feature work safely with Git worktrees', 'Standardizes branch isolation, port allocation, environment sync, and cleanup' — giving comprehensive coverage of the skill's capabilities without padding. It is written in third person ('Run', 'Standardizes'), so no voice penalty applies.

5 / 5

Completeness

It explicitly answers both what ('Run parallel feature work... Standardizes branch isolation, port allocation, environment sync, and cleanup so each worktree behaves like an independent local app') and when ('Use when running multiple feature branches simultaneously, isolating experimental work, or coordinating multi-agent development across the same repo') with concrete trigger phrases. Not 4, because the 'when' clause is explicit and enumerates specific scenarios rather than being generic.

5 / 5

Trigger Term Quality

Natural phrases like 'Git worktrees', 'running multiple feature branches simultaneously', 'isolating experimental work', and 'coordinating multi-agent development' match what users would actually say, but a few natural variations (e.g., 'parallel development', 'hotfix branches') are missing. This sits between 'good keyword coverage' (4) and 'comprehensive coverage with synonyms' (5), closer to 4.

4 / 5

Distinctiveness Conflict Risk

It carves a clear niche — Git worktree parallelism with port/environment isolation for multi-agent workflows — with triggers ('worktrees', 'multiple feature branches simultaneously') that are unlikely to fire for unrelated skills. Not 4, because there is no meaningful overlap with adjacent skills; the trigger terms are distinct.

5 / 5

Total

19

/

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

relative_links

Relative link issues: 5 missing

Warning

referenced_paths_exist

Referenced path issues: 11 missing

Warning

Total

14

/

16

Passed

Repository

alirezarezvani/claude-skills

Path

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