CtrlK
BlogDocsLog inGet started
Tessl Logo

using-git-worktrees

Use when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback

64

Quality

76%

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 ./eval/local/skills/benchmarks/dependency/superpowers/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.

A well-sequenced, highly actionable instruction skill with strong validation checkpoints and error-recovery loops throughout. Its main weakness is redundancy — Common Mistakes, Red Flags, and the Quick Reference table restate the step guidance — and a few placeholder variables that keep commands from being fully copy-paste ready.

Suggestions

Consolidate the overlapping 'Common Mistakes', 'Red Flags', and 'Quick Reference' sections into a single reference table — the 'prefer native tools', 'run Step 0 first', and 'verify ignored' rules currently appear three to four times each.

Define the placeholder variables concretely in Step 1b (e.g., show how LOCATION is resolved from the directory-selection steps and how BRANCH_NAME is derived) so the worktree-creation snippet is copy-paste executable.

Replace the 'npm test / cargo test / pytest / go test ./...' menu in Step 3 with the same auto-detection pattern used in Step 2, or an explicit mapping from detected project type to test command.

DimensionReasoningScore

Conciseness

The procedural steps themselves are tight and code-first with no explanation of concepts Claude already knows, but the same guidance is repeated three to four times: the steps, the Quick Reference table, "Common Mistakes", and "Red Flags" all restate 'prefer native tools', 'run Step 0 first', and 'verify ignored'. This duplication is unnecessary padding that could be consolidated, matching 'mostly efficient but could be tightened'; it is not the severe concept-explanation padding of a 2.

3 / 5

Actionability

Most guidance is concrete and executable ("git check-ignore -q .worktrees", "git worktree add \"$path\" -b \"$BRANCH_NAME\"", language-detected setup commands), but minor gaps remain: "path=\"$LOCATION/$BRANCH_NAME\"" uses undefined placeholder variables, and "npm test / cargo test / pytest / go test ./..." is a menu rather than a copy-paste command. This fits 'mostly executable guidance with minor gaps' rather than the fully copy-paste-ready coverage of a 5.

4 / 5

Workflow Clarity

The sequence (Step 0 detect → Step 1 create → Step 2 setup → Step 3 baseline verify) is explicit, with validation checkpoints (check-ignore before creating, submodule guard, baseline test verification) and feedback loops for error recovery ("If tests fail: Report failures, ask whether to proceed", sandbox-denial fallback, add-to-.gitignore remediation). The Quick Reference table serves as a checklist, matching the top anchor.

5 / 5

Progressive Disclosure

As a single-file skill with no references/ or scripts/ bundle, everything lives in SKILL.md, but the content is well-sectioned with clear headers (detect → create → setup → verify → quick reference) and the ~200-line body stays navigable. It does not reach 5 because the guideline reserving a 5 for well-organized under-50-line skills does not apply here, and the duplicated Common Mistakes/Red Flags sections are organization slack; it is clearly above the 'should be separate is inline' disorganization of a 3.

4 / 5

Total

16

/

20

Passed

Description

78%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 with an explicit 'Use when' trigger clause, clear what/when coverage, and reasonable natural-language trigger terms. Its main limitation is that it compresses the skill into a single 'ensures an isolated workspace exists' action rather than enumerating its concrete capabilities.

DimensionReasoningScore

Specificity

The description names the domain (workspace isolation) and one core action ("ensures an isolated workspace exists") with two mechanisms ("via native tools or git worktree fallback"), but does not enumerate the concrete actions the skill actually performs (detect existing isolation, verify ignore status, run setup, baseline tests). It sits at 'names domain and 1-2 concrete actions, but not comprehensive'; score 4 would require several distinct specific actions listed, which is not met.

3 / 5

Completeness

It explicitly answers both: 'what' — "ensures an isolated workspace exists via native tools or git worktree fallback" — and 'when' with an explicit "Use when" clause carrying two concrete trigger conditions ("starting feature work that needs isolation from current workspace", "before executing implementation plans"). Score 4 would require the 'when' to be less explicit, which it is not.

5 / 5

Trigger Term Quality

Relevant phrases include "starting feature work", "isolation from current workspace", "implementation plans", and "worktree" — natural terms a user would say when needing this skill. A few common variations are missing (e.g., "branch off", "separate copy", "don't touch my working directory"), so it does not reach the comprehensive synonym/extension coverage of a 5.

4 / 5

Distinctiveness Conflict Risk

The worktree-isolation niche is clear and mostly distinct, but "before executing implementation plans" creates minor overlap risk with general plan-execution / implementation skills that might also plausibly claim that trigger. It is not the 'clear niche with minimal conflict' of a 5, but well above the broad overlap of a 3.

4 / 5

Total

16

/

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
rpamis/comet
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.