CtrlK
BlogDocsLog inGet started
Tessl Logo

nv-worktree-cleanup

Audits git worktrees and removes the ones that are safe to delete — merged into the base branch (including squash-merges via `gh`), missing on disk, or explicitly confirmed by the user — then deletes the associated local branches and runs `git worktree prune`. Use when the user asks to clean up worktrees, prune worktrees, list stale worktrees, remove merged worktrees or branches, or reclaim disk space from old checkouts.

76

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.

The content is a well-engineered operational runbook: exact commands, a complete classification table, safety rules, ordering constraints, and anti-patterns that anticipate real failure modes (squash-merge detection, branch-before-worktree deletion order). Its only weaknesses are minor redundancy in the repeated safety emphasis and a body long enough that some illustrative material could be offloaded to a reference file.

Suggestions

Deduplicate the force-removal rule stated in Hard rule 1, step 5's inline comments, and the first anti-pattern into a single authoritative statement.

Move the Example session (and optionally the base-branch fallback chain) into a references/ file, keeping SKILL.md focused on the workflow itself.

Trim the repeated explanation of why `-d` refuses squash-merged branches (it appears in the classification table, step 5, and an anti-pattern) to one location.

DimensionReasoningScore

Conciseness

The body is lean and assumes git competence — no concept explanations, dense classification table, purposeful Anti-patterns section — but safety guidance repeats across 'Never `--force` remove… without explicit user confirmation' (Hard rule 1), the step-5 comments, and the first anti-pattern. That trimmable redundancy fits the 'efficient; minor instances… could be trimmed' anchor (4) rather than the every-token-earns-its-place anchor (5).

4 / 5

Actionability

Fully executable throughout: `git worktree list --porcelain`, `git symbolic-ref refs/remotes/origin/HEAD`, `git merge-base --is-ancestor <branch> origin/<base>`, `gh pr list --state merged --head <branch> --json number`, and the exact remove/branch-delete commands with when-to-use-`-D` conditions. Commands are copy-paste ready and the classification table gives detection criteria for every case — matches the 5 anchor.

5 / 5

Workflow Clarity

A clear six-step sequence with explicit validation checkpoints throughout a destructive batch operation: `git fetch --prune origin` before merge checks, per-worktree classification before any action, one consolidated `AskQuestion` approval, safe `git branch -d` that 'refuses if unmerged' as a built-in guard, and a closing report of removals, skips, and failures. Validation is present and explicit, so the destructive-batch cap of 3 does not apply; the error-recovery reporting matches the 5 anchor.

5 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ absent) and the skill is a single well-sectioned document with clear headers (Hard rules, Workflow steps 1–6, Anti-patterns, Example session) — appropriate for a ~110-line procedural skill. Not a 5: at this length, the Example session and the base-branch fallback details are content that could live in a separate reference file, leaving SKILL.md a tighter overview.

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.

The description is exemplary: it states concrete actions with their safety criteria in third person, provides an explicit 'Use when' clause with multiple natural trigger phrases, and occupies a distinct niche. It directly matches the rubric's good-overall examples in structure and quality.

DimensionReasoningScore

Specificity

Quotes multiple concrete actions — 'Audits git worktrees and removes', 'merged into the base branch (including squash-merges via `gh`)', 'missing on disk', 'deletes the associated local branches and runs `git worktree prune`' — matching the comprehensive-coverage anchor (5). It goes beyond the 4 anchor by enumerating the exact safety criteria and follow-up actions rather than leaving minor gaps.

5 / 5

Completeness

Both what ('Audits git worktrees and removes the ones that are safe to delete… then deletes the associated local branches and runs `git worktree prune`') and when ('Use when the user asks to clean up worktrees…') are explicit and concrete, exactly matching the 5 anchor. Not a 4 because the 'when' clause lists specific trigger phrases rather than being merely adequate.

5 / 5

Trigger Term Quality

'Use when the user asks to clean up worktrees, prune worktrees, list stale worktrees, remove merged worktrees or branches, or reclaim disk space from old checkouts' covers natural phrasings with synonyms (worktrees, branches, checkouts, stale). It fits the comprehensive natural-terms anchor (5); no common user phrasing for this domain is missing.

5 / 5

Distinctiveness Conflict Risk

The git-worktree cleanup niche is distinct with domain-specific triggers ('worktrees', 'prune worktrees', 'merged worktrees or branches'), and even the broadest phrase ('reclaim disk space') is scoped to 'old checkouts'. Clear niche with minimal conflict risk — the 5 anchor; it does not overlap with generic file- or code-management skills.

5 / 5

Total

20

/

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