CtrlK
BlogDocsLog inGet started
Tessl Logo

merge

Merge changes from the topic branch to the merge base branch. Use when the user wants to merge their session's work back to the base branch.

72

Quality

89%

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

100%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 instruction-only skill body: fully executable git commands, a clearly sequenced workflow with explicit validation and conflict-recovery paths, and lean well-organized sections with no bundled files needed. Nothing material is missing or padded.

DimensionReasoningScore

Conciseness

The body is lean throughout — every section is either a guardrail, a concrete command, or a validation check, with zero explanation of git concepts Claude already knows (e.g., "Check for uncommitted changes: git status --porcelain"). Not a 4 because there is no padding or over-explanation anywhere to trim.

5 / 5

Actionability

Every step is an executable, copy-paste-ready command with explicit placeholders (e.g., "git -C <main-worktree-path> merge <topic-branch>", "git -C <main-worktree-path> merge-base --is-ancestor <topic-branch> HEAD"), and conflict resolution covers the common case including the abort path. Not a 4 because no key execution detail is missing.

5 / 5

Workflow Clarity

The workflow is clearly sequenced (commit uncommitted changes → merge → resolve conflicts → validate) with an explicit Validation section containing two verification commands, and conflict handling includes error-recovery feedback (resolve-and-stage, ask user, or "merge --abort"). The destructive-operation validation cap does not apply because validation steps are present. Not a 4 because checkpoints are explicit rather than implicit, covering both a clean worktree and full-merge verification.

5 / 5

Progressive Disclosure

The skill is a short, single-purpose procedure with no bundle files (no references/, scripts/, or assets/ exist) and no need for external references; it is organized into well-signaled sections (Guidelines, Workflow, Validation) that keep everything one level deep. Per the rubric's simple-skill guidance, this warrants a 5. Not a 4 because there is no content that should have been split out into separate files.

5 / 5

Total

20

/

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 clear, well-structured description that explicitly states what the skill does and when to use it, with natural trigger phrasing tied to the session/worktree workflow. Its main limitation is narrow capability coverage — it names only the core merge action — and limited synonym coverage for triggers.

Suggestions

Add one or two secondary capabilities (e.g., resolving merge conflicts, committing uncommitted session work) to the 'what' portion to lift specificity.

Include trigger variations or synonyms such as 'integrate changes', 'combine branches', or 'sync session work' so more natural user phrasings match.

Consider mentioning the worktree context in the description to further distinguish it from generic git-merge skills.

DimensionReasoningScore

Specificity

The description states one concrete action — "Merge changes from the topic branch to the merge base branch" — naming the domain (git merge between branches) but listing no secondary actions or conflict handling, matching the '1-2 concrete actions, but not comprehensive' anchor. Not a 4 because it does not list several specific actions; not a 2 because the action and target are concrete, not generic.

3 / 5

Completeness

It explicitly answers both: what — "Merge changes from the topic branch to the merge base branch" — and when — "Use when the user wants to merge their session's work back to the base branch", a concrete trigger phrase in third person. Not a 4 because the 'when' clause is fully explicit rather than only weakly implied or generic.

5 / 5

Trigger Term Quality

Natural phrases like "merge their session's work back to the base branch" and "merge changes" mirror what a user in this workflow would actually say. Not a 5 because it lacks synonyms and variations (e.g., "integrate", "combine branches", "sync work back") that would broaden trigger coverage; not a 3 because the core natural terms are present and well-phrased.

4 / 5

Distinctiveness Conflict Risk

Terms like "topic branch", "merge base branch", and "session's work" tie it to the worktree workflow, making it mostly distinct. Not a 5 because "merge" alone overlaps with any general git-merge skill; not a 3 because the worktree-specific vocabulary meaningfully narrows the trigger surface.

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
posit-dev/positron
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.