CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

using-git-worktrees

Skill de isolamento de workspace via git worktree, com deteccao de isolamento existente, preferencia por ferramenta nativa (`EnterWorktree`/`ExitWorktree` ou dispatcher do kit `/worktree`) antes de cair para `git worktree add` cru, e baseline de testes obrigatoria antes de liberar a task para trabalho. Eleva o comando `/worktree` do kit para protocolo completo quando a situacao exige as garantias extras (evitar aninhamento de worktree, confirmar workspace limpo antes de comecar). Trigger em: "worktree", "isolar workspace", "trabalhar isolado", "workspace isolado", "criar worktree", "ja estou num worktree", "aninhar worktree", "worktree dentro de worktree", "baseline de testes", "verificar baseline limpa", "detectar isolamento", "git worktree add", "ferramenta nativa de worktree", "EnterWorktree", "plano de implementacao isolado", "trabalho paralelo sem afetar o branch atual".

75

Quality

94%

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

88%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-engineered operational protocol: fully executable commands, an explicit validation-first sequence with feedback loops, and clear error handling. The main costs are redundant summary tables that restate the steps and references to kit files that are not part of this skill's bundle.

Suggestions

Trim the "Referência Rápida" and "Racionalizações Comuns" tables (or merge them into the relevant steps) — they restate step content almost verbatim and account for the bulk of the redundancy.

Qualify the external kit references (`GLOBAL.md`, `policies/*.md`, `commands/worktree.md`, `scripts/worktree.mjs`) as parent-kit context, or move any detail Claude actually needs into a references/ file inside the skill so the bundle is self-contained.

The "Relação com `commands/worktree.md`" section largely repeats the introduction; fold its one new fact (v2.65.0 script behavior) into the intro and delete the section.

DimensionReasoningScore

Conciseness

The core protocol (Passos 0-3) is lean with executable commands and no teaching of concepts Claude already knows. However, the "Referência Rápida" table restates the step outcomes, "Racionalizações Comuns" re-argues points already made in the steps, and "Relação com `commands/worktree.md`" repeats the intro's framing — together ~40 lines that could be trimmed. Not a 5 because of this duplicate restating; not a 3 because the redundancy is deliberate summary/anti-rationalization framing, not unnecessary concept explanation.

4 / 5

Actionability

Commands are copy-paste ready for the common cases: detection (`git rev-parse --git-dir`/`--git-common-dir`, `--show-superproject-working-tree`), ignore verification (`git check-ignore -q .worktrees`), creation (`git worktree add "$path" -b "$BRANCH_NAME"`), setup auto-detection, and baseline tests. Error paths are concretely handled (sandbox permission fallback, test-failure reporting). Not a 4 because even edge cases (submodule guard, both-directory conflict) have explicit executable checks.

5 / 5

Workflow Clarity

Steps 0-3 are clearly sequenced with explicit validation checkpoints: submodule guard before concluding "already in a worktree", `git check-ignore` MUST before creating the worktree, and the mandatory test baseline before releasing the task. Feedback loops are present for both failure modes (permission error -> work in place; failing baseline -> report + ask). Not a 4 because validation is not just present but marked MUST/obrigatório with explicit recovery paths.

5 / 5

Progressive Disclosure

Section structure is clear and navigable (Passos, tables, source attribution) with no nested references, and the ~180 lines are all operationally relevant so a single-file layout is defensible. But the body references files outside the skill bundle (`GLOBAL.md`, `policies/execution.md`, `commands/worktree.md`, `scripts/worktree.mjs`) that are not present in references/, scripts/, or assets/ and cannot be resolved from the bundle. Not a 5 because those external references are not well-signaled as kit-context; not a 3 because organization within SKILL.md itself is good.

4 / 5

Total

18

/

20

Passed

Description

100%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 capabilities with named tools, an explicit and comprehensive trigger list, and clear what/when coverage tightly scoped to the git worktree isolation niche. Third-person voice is maintained and there is no vague padding.

DimensionReasoningScore

Specificity

The description lists multiple concrete, named actions: "deteccao de isolamento existente", "preferencia por ferramenta nativa (`EnterWorktree`/`ExitWorktree` ou dispatcher do kit `/worktree`) antes de cair para `git worktree add` cru", and "baseline de testes obrigatoria antes de liberar a task". Coverage is comprehensive for the worktree-isolation domain with no vague filler. Not a 4 because unlike 'minor gaps in coverage', every capability of the protocol (detect, prefer native tool, fallback, baseline) is explicitly named.

5 / 5

Completeness

Both 'what' and 'when' are explicit: the first sentences state the concrete capabilities, and "Trigger em: ..." enumerates concrete trigger phrases — the equivalent of an explicit 'Use when...' clause with no cap applied. Not a 4 because the 'when' is not merely present but enumerated with specific phrases rather than a single generic clause.

5 / 5

Trigger Term Quality

The trigger list is comprehensive and natural: "worktree", "isolar workspace", "trabalhar isolado", "criar worktree", "ja estou num worktree", "aninhar worktree", "worktree dentro de worktree", "baseline de testes", "git worktree add", "EnterWorktree", "trabalho paralelo sem afetar o branch atual". It covers synonyms, tool names, and exact commands users would type. Not a 4 because no common phrasing of this need is missing.

5 / 5

Distinctiveness Conflict Risk

Every trigger is anchored to the worktree-isolation niche (worktree, isolation, baseline, branch protection), e.g. "trabalho paralelo sem afetar o branch atual" scopes the parallelism trigger to the exact conflict this skill prevents. Not a 4 because overlap risk with adjacent skills (branch switching, parallel agents) is minimal — the qualified phrasing disambiguates them.

5 / 5

Total

20

/

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: 3 missing

Warning

Total

15

/

16

Passed

Repository

felvieira/claude-skills-fv

Path

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