CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

using-git-worktrees

Use when starting feature work that needs isolation from current workspace or before executing implementation plans - creates isolated git worktrees with smart directory selection and safety verification

2.32x
Quality

77%

Does it follow best practices?

Impact

100%

2.32x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/using-git-worktrees/SKILL.md

The canonical home for this skill is using-git-worktrees in obra/superpowers

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.

The body delivers an exceptionally clear, validated workflow with concrete commands and explicit safety checkpoints — the strongest aspect of this skill. Its main weaknesses are redundancy across the Quick Reference, Common Mistakes, Red Flags, and Example Workflow sections, and a creation snippet that is a fragment rather than executable code.

Suggestions

Consolidate the overlapping Quick Reference table, Common Mistakes, and Red Flags sections into a single checklist — they restate the same rules (verify ignored, follow directory priority, don't proceed with failing tests) three to four times.

Make the creation step executable: define $LOCATION/$BRANCH_NAME or show the actual command per location, and quote-expand '~' correctly ("$HOME/.config/...") since '~' does not expand inside double quotes.

Trim the Example Workflow section, which replays the entire already-documented procedure, down to just the final report format.

DimensionReasoningScore

Conciseness

The core instructions are lean and command-driven, but the same rules are repeated across three summary sections (Quick Reference table, Common Mistakes, Red Flags) and again in the Example Workflow — e.g., 'verify ignored' appears in all four. This matches 'mostly efficient but could be tightened' rather than anchor 4's 'minor instances'.

3 / 5

Actionability

Concrete, executable bash commands and exact user-facing prompts cover directory detection, ignore verification, worktree creation, and setup auto-detection. It falls short of anchor 5 because the creation snippet is a fragment referencing undefined $LOCATION/$BRANCH_NAME variables and an unexpanded '~' inside quotes, so it is not copy-paste ready.

4 / 5

Workflow Clarity

A clearly sequenced workflow (select directory → verify ignored → create → setup → baseline test → report) with explicit validation checkpoints (git check-ignore, baseline tests) and feedback loops ('If tests fail: Report failures, ask whether to proceed or investigate'). This matches the top anchor including error-recovery guidance.

5 / 5

Progressive Disclosure

A single-file skill with no bundle files, well-organized sections, and easy navigation; no nested or buried references. It misses anchor 5 because some inline content (Common Mistakes, Example Workflow) duplicates the core sections and could be trimmed or split, leaving minor organization gaps.

4 / 5

Total

16

/

20

Passed

Description

70%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 well-structured with an explicit and specific 'Use when...' trigger clause and a clear domain, but the capability half leans on buzzword qualifiers ('smart directory selection', 'safety verification') instead of enumerating concrete actions. Overall a solid, distinguishable description with room to sharpen the 'what'.

Suggestions

Replace vague qualifiers with concrete actions, e.g., 'creates isolated git worktrees, verifies the worktree directory is gitignored, auto-detects and runs project setup, and verifies a clean test baseline'.

Add natural trigger synonyms users would actually say, such as 'parallel branches', 'isolated workspace', or 'work on a separate branch' alongside the existing triggers.

State the trigger guidance in third person and keep the what-then-when ordering consistent ('Creates isolated git worktrees with directory selection and safety verification. Use when...').

DimensionReasoningScore

Specificity

The description names the domain ("creates isolated git worktrees") but the remaining capabilities are abstract qualifiers — "smart directory selection and safety verification" — rather than several concrete actions, matching the 1-2 concrete actions anchor. It falls below anchor 4 because buzzword-like phrases replace a list of specific actions.

3 / 5

Completeness

Both what ("creates isolated git worktrees with smart directory selection and safety verification") and an explicit when ("Use when starting feature work that needs isolation... or before executing implementation plans") are present with concrete triggers. It misses anchor 5 because the 'what' half relies on vague qualifiers instead of concrete capability verbs.

4 / 5

Trigger Term Quality

Natural phrases users would say are present ("starting feature work", "isolation from current workspace", "implementation plans", "git worktrees"), giving good coverage. A few natural synonyms are missing (e.g., "parallel branches", "isolate changes", "new branch"), keeping it below anchor 5.

4 / 5

Distinctiveness Conflict Risk

Worktree creation is a distinct niche with clear triggers (isolation, feature work, implementation plans), only marginally overlapping generic planning or git skills. Not anchor 5 because "before executing implementation plans" could fire on general implementation-planning skills.

4 / 5

Total

15

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

valeriibeck-star/claude-skills

Path

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.