CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

using-git-worktrees

当需要开始与当前工作区隔离的功能开发,或在执行实现计划之前使用——通过原生工具或 git worktree 回退机制确保隔离工作区存在

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

81%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.

An exemplary operational skill body: a fully sequenced workflow with genuine validation checkpoints (submodule guard, ignore-status verification, baseline tests) and error-recovery paths, written in tight, command-first Chinese prose with two useful summary tables. The only deductions are minor: placeholder variables in the worktree-creation snippet and some redundancy between the quick-reference and rationalization tables.

Suggestions

In the worktree-creation block, replace the implied $LOCATION/$BRANCH_NAME placeholders with concrete example values or an inline one-line derivation (e.g. path=".worktrees/$BRANCH_NAME") so the command is copy-paste ready.

Consider folding the '快速参考' and '常见的合理化借口' tables into one table (situation → action → excuse it defeats) to cut the duplication and tighten token use.

If the skill grows, move the per-ecosystem setup/test matrix (步骤 2/3) into a references/ file so SKILL.md stays a lean overview.

DimensionReasoningScore

Conciseness

The body is lean: commands come with one-line comments, justifications are single sentences ("**为什么关键:** 防止 worktree 内容被意外提交到仓库"), and it never explains concepts Claude already knows. It stops short of anchor 5 only because the '常见的合理化借口' table and the '快速参考' table restate rules already spelled out in the steps — one of the two could be trimmed. Comfortably above anchor 3's 'some unnecessary explanation'.

4 / 5

Actionability

Nearly everything is copy-paste-ready bash: the GIT_DIR/GIT_COMMON detection, the submodule guard, `git check-ignore -q`, the per-ecosystem setup and test commands. The gap that keeps it from anchor 5 is the creation block `path="$LOCATION/$BRANCH_NAME"` / `git worktree add "$path" -b "$BRANCH_NAME"`, which uses placeholder variables whose values are only implied by the prose priority list rather than given concretely.

4 / 5

Workflow Clarity

Steps 0-3 are explicitly sequenced (detect existing isolation → create via native tool or git fallback → project setup → baseline validation), with real validation checkpoints: the submodule guard, the mandatory `git check-ignore` verification before creation, baseline tests before any work, and recovery paths (sandbox fallback to work in place, ask-the-user on test failure). The quick-reference table doubles as a checklist — a clear match for anchor 5's 'explicit validation steps, feedback loops, checklists'.

5 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are absent) and the body references no external paths, so there are no broken or buried references; sections are clearly headed and easy to navigate. It scores 4 rather than 5 because at ~165 lines, some content (the per-language setup/test matrix and the two summary tables) could plausibly live in a reference file — the 'no external references needed' exemption is scoped to skills under 50 lines. Still well above anchor 3, which requires inline content that clearly belongs elsewhere or buried references.

4 / 5

Total

17

/

20

Passed

Description

82%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 well-formed trigger description that explicitly answers both 'what' (ensure an isolated workspace exists, native tools first with git worktree fallback) and 'when' (starting isolated feature work, before executing an implementation plan), with a clear niche and low conflict risk. Its only real weakness is specificity: it summarizes the mechanism rather than enumerating the skill's concrete actions.

Suggestions

Enumerate 2-3 of the skill's concrete operations in the description (e.g. detect existing worktree isolation, verify the worktree directory is git-ignored, run baseline tests before starting) to raise specificity from a single summarized action.

Add one or two natural synonyms users might say (e.g. '并行开发' / parallel development, '独立分支工作区') to broaden trigger-term coverage.

DimensionReasoningScore

Specificity

The description names its domain clearly ("通过原生工具或 git worktree 回退机制确保隔离工作区存在") and states one concrete action with two mechanisms, but does not enumerate the skill's other concrete operations (detecting existing isolation, verifying ignore status, running baseline tests). This matches anchor 3 ("names domain and 1-2 concrete actions, but not comprehensive") better than anchor 4, which expects several listed specific actions.

3 / 5

Completeness

Both halves are explicit: the 'when' is a concrete trigger clause ("当需要开始与当前工作区隔离的功能开发,或在执行实现计划之前使用") and the 'what' is stated plainly ("确保隔离工作区存在" with the native-tool-first / git-worktree-fallback mechanism). This clearly matches anchor 5 rather than anchor 4, whose 'when' is weaker or less specific.

5 / 5

Trigger Term Quality

It carries several natural trigger terms users would actually say: "git worktree", "隔离工作区" (isolated workspace), "功能开发" (feature development), "实现计划" (implementation plan), "隔离" (isolate). It sits between anchor 3 (missing common variations) and anchor 5 (comprehensive synonyms/extensions), matching anchor 4's 'good coverage with a few natural terms missing' — e.g. no mention of 'branch', 'parallel development', or '.worktrees'.

4 / 5

Distinctiveness Conflict Risk

It occupies a clear niche — workspace isolation via worktrees — with distinct triggers ('隔离工作区', 'git worktree', '原生工具') that no generic git or environment-setup skill would fire on. Minimal overlap risk, matching anchor 5; anchor 4 would require demonstrable overlap with a closely related skill, which is not the case here.

5 / 5

Total

17

/

20

Passed

Validation

81%

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

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

13

/

16

Passed

Repository

jnMetaCode/superpowers-zh

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.