CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

worktree-from-issue

Create a git worktree with a new branch for implementing a fix or feature for a GitHub issue

Quality

83%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

96%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, highly actionable command skill: concrete commands at every step, explicit validation with feedback loops, and no wasted tokens. The only structural note is that it is a single-file monolith with no progressive-disclosure layer, which is acceptable at this size but keeps it off the top anchor.

DimensionReasoningScore

Conciseness

The body is lean and every section earns its place: steps are terse, and the few explanatory lines ('--no-track leaves the branch without an upstream', 'Note which secrets source was used') convey project-specific facts Claude cannot infer rather than padding. Matches anchor 5 ('lean and efficient; assumes Claude's competence') — there is no over-explanation of known concepts that would warrant 4.

5 / 5

Actionability

Every step ships an executable command or template: 'gh issue view <issue_number> --json number,title,state', 'git fetch origin devel', '/create-worktree <short_name> --branch origin/devel', 'git -C <worktree-path> checkout --no-track -b <branch_name>', and a concrete report block. Fully copy-paste ready with the branch-name regex for validation, matching anchor 5.

5 / 5

Workflow Clarity

Seven clearly sequenced steps with explicit validation checkpoints and error recovery: step 1 validates the branch name against a regex, step 2 verifies the issue exists, and step 6 re-checks pwd and 'stop[s] with an error if the cwd cannot be set' — a genuine validate/retry feedback loop. Worktree creation is additive, not destructive or batch, so the destructive-operation cap does not apply. Matches anchor 5.

5 / 5

Progressive Disclosure

No bundle files exist, and the skill is well organized with clear sections and clean delegation to sibling skills ('/create-worktree', '/worktree-make-dev') that are clearly signaled. However, the ~93-line body exceeds the simple-skill (<50 line) exception and is a self-contained monolith without the overview-plus-one-level-references pattern of the 5 anchor. Matches anchor 4 ('good structure; most content appropriately placed; references mostly clear').

4 / 5

Total

19

/

20

Passed

Description

65%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 concise, concrete, and clearly distinct, but it answers only 'what' — the 'when to use it' half is entirely absent, which caps completeness and limits trigger discoverability. Adding an explicit trigger clause would lift the two weakest dimensions.

Suggestions

Add an explicit trigger clause, e.g. 'Use when starting work on a GitHub issue that needs an isolated workspace, or when the user mentions creating a worktree or issue branch.'

Include one or two natural trigger variations users might say, such as 'fix or feature branch' or 'isolated checkout', to broaden trigger-term coverage.

Optionally mention the argument format (<category>/<issue-number>-<short-description>) in the description so users invoking it manually know what to pass.

DimensionReasoningScore

Specificity

Names the domain (git worktree, branch, GitHub issue) and one composite concrete action ('Create a git worktree with a new branch'), but coverage is not comprehensive — no mention of argument parsing, issue verification, or environment setup. Matches anchor 3 ('names domain and 1-2 concrete actions, but not comprehensive') rather than 4, which requires several listed specific actions.

3 / 5

Completeness

The 'what' is clear and concrete, but there is no 'Use when...' clause or equivalent explicit trigger guidance — 'for implementing a fix or feature for a GitHub issue' only weakly implies when to use it. Per the judging guidelines, a missing explicit trigger clause caps completeness at 3; it is not 4 because 'when' is never explicitly stated.

3 / 5

Trigger Term Quality

'git worktree', 'branch', 'fix', 'feature', and 'GitHub issue' are terms users would naturally say when needing this skill. Good keyword coverage, but a few natural variants are missing (e.g., 'isolated checkout', 'issue branch'), so it fits anchor 4 rather than the comprehensive synonym coverage of 5.

4 / 5

Distinctiveness Conflict Risk

The description carves out a clear niche (worktree creation with an issue-based branch for GitHub work) with distinct trigger terms, so conflict with generic git or branch skills is minimal. Matches anchor 5 ('clear niche with distinct triggers; minimal conflict risk').

5 / 5

Total

15

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository

dlt-hub/dlt

Path

.claude/skills/worktree-from-issue/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.