CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

nv-worktree-create

Create a sibling git worktree and a new branch with the same name, copy local `.env` files, optionally initialize the enterprise submodule (`--enterprise`), and move the agent into the worktree. Use when the user asks for a worktree, parallel branch checkout, or `/worktree` with a branch name.

Quality

92%

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 tight, high-signal procedural skill: sequenced steps with real commands, explicit abort/warn checkpoints, OSS-mode failure fallback, and a strong Do-not list guarding known failure modes. The two soft spots are the env-copy recipe being external to the file and the enterprise subsection carrying detail that belongs in its referenced companion skill.

Suggestions

Inline the fast `git ls-files` env-copy recipe (or at least the `--lite` core-apps variant) in step 3 so the copy step is executable without first loading `nv-worktree-commands`.

Trim the `--enterprise` subsection to the trigger, preference order, and OSS-mode fallback, moving the candidate-clone list and HTTPS/submodule commands into the referenced `enterprise-submodule` material.

Clarify in the Example section that the shown output is what the agent should report at the Confirm step, tying the example directly to step 6.

DimensionReasoningScore

Conciseness

Every line is operational with no padding or explanation of concepts Claude already knows — e.g. "Abort if the target path already exists" and "Do **not** run `setup-env-files.js` — it regenerates encryption keys". Rationale-bearing parentheticals ("walks `node_modules`/`.nx`, ~10s") convey failure modes and costs rather than background, fitting the anchor 'lean and efficient; every token earns its place'.

5 / 5

Actionability

Concrete, copy-paste-ready commands cover preflight (`git rev-parse --show-toplevel && git worktree list && git status --porcelain`), creation (`git worktree add -b <branch> <worktree-path> [<base-ref>]`), and submodule init, plus a worked `/worktree` example and a specific handoff tool (`move_agent_to_root`). It falls short of 5 because the env-copy step's actual recipe ("Use the fast `git ls-files` recipe in `nv-worktree-commands`") is deferred to another skill rather than shown, leaving a minor executable gap in step 3.

4 / 5

Workflow Clarity

Six clearly sequenced steps with explicit validation checkpoints and feedback loops: preflight abort ("Abort if the target path already exists"), a dirty-tree confirmation ask, enterprise skip conditions and failure fallback ("If enterprise setup fails, warn and continue in OSS mode — do not block the worktree"), and a final confirm checklist of what to report. This matches the top anchor; the operations are also non-destructive, so the missing-validation cap does not apply.

5 / 5

Progressive Disclosure

Well-organized sections with clearly signaled, one-level-deep references ("For git command details and path naming, read `nv-worktree-commands`"; "For cleanup, read `nv-worktree-cleanup`"). Not a 5 because this bundle has no reference files of its own and the dense `--enterprise` subsection (candidate clones, HTTPS fallback, symlink refresh) largely duplicates material that could live in the referenced `enterprise-submodule` skill.

4 / 5

Total

18

/

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 model description: third-person, concrete action list with explicit flag semantics, and an explicit 'Use when' clause with natural trigger phrases. The only improvement space is broader synonym coverage in the trigger terms.

DimensionReasoningScore

Specificity

It lists multiple specific concrete actions — "Create a sibling git worktree and a new branch with the same name, copy local `.env` files, optionally initialize the enterprise submodule (`--enterprise`), and move the agent into the worktree" — comprehensively covering the skill's behavior with no vague filler. This matches the anchor for comprehensive concrete actions; it is not a 4 because there are no coverage gaps in the action list.

5 / 5

Completeness

Both halves are explicit: the 'what' is the concrete action list, and the 'when' is "Use when the user asks for a worktree, parallel branch checkout, or `/worktree` with a branch name" — concrete trigger phrases. This matches the top anchor exactly; a 4 would require the when-clause to be less specific than it is.

5 / 5

Trigger Term Quality

"worktree", "parallel branch checkout", and "`/worktree` with a branch name" are natural phrases a user would say, giving good keyword coverage. It stops short of a 5 because common variants like "git worktree", "isolated checkout", or "second copy of the repo" are absent, and it is above a 3 since the included terms are on-target rather than merely relevant.

4 / 5

Distinctiveness Conflict Risk

The trigger surface is a clear niche — worktree creation with named flags (`--enterprise`, `/worktree`) — making it unlikely to fire for unrelated skills. The named-skill triggers (`/worktree`, "parallel branch checkout") are distinct, matching the 'clear niche with distinct triggers' anchor.

5 / 5

Total

19

/

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

novuhq/novu

Path

.cursor/skills/nv-worktree-create/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.