CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

weave-merge-preview

Preview how a named branch would merge into HEAD using the locally installed Weave CLI, without applying the merge. Use when reviewing overlapping branch or parallel-agent changes.

Quality

88%

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

92%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 body is a model of lean, executable instruction: concrete commands with explicit placeholder handling, an ordered workflow with tool verification and error recovery, and explicit do-not-exceed boundaries. Its only blemish is the time-sensitive "(tested with 0.5.4)" version pin, which is the sole reason conciseness does not score 5.

DimensionReasoningScore

Conciseness

The body is lean and purely instructional ("Use `weave preview BRANCH`, replacing BRANCH with the shell-quoted requested ref") with every sentence directing action, but the time-sensitive pin "(tested with 0.5.4)" is the one trims-worthy instance per the version-number guideline, holding it at "minor instances of over-explanation" (anchor 4) rather than anchor 5.

4 / 5

Actionability

Commands are concrete and executable as written — `weave --version`, `weave preview BRANCH`, and `weave preview BRANCH --file path/to/file` — with explicit placeholder-substitution guidance and both the whole-branch and single-file cases covered; not 4 because there is no material gap in the common cases.

5 / 5

Workflow Clarity

The sequence is clear and ordered (confirm the tool via `weave --version`, identify the ref, check working-tree status, preview, then "Report the conflicts or independent entity changes the preview actually shows") with an explicit error-recovery path ("If absent, explain the prerequisite"); the skill is explicitly read-only, so the destructive-operation validation cap does not apply.

5 / 5

Progressive Disclosure

At ~25 lines with no external references needed and no bundle files present, the single well-organized flow satisfies the simple-skill exception: nothing is inlined that belongs in a separate file, and there are no nested or buried references.

5 / 5

Total

19

/

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.

The description is concise, third-person, and explicitly answers both what the skill does and when to use it, with a clear read-only scope. Its main weaknesses are single-action coverage and the omission of the most natural user trigger phrase ("merge conflicts"), which keep specificity and trigger-term quality in the mid range.

Suggestions

Broaden capability coverage by naming the second concrete action, e.g. "Preview how a named branch would merge into HEAD and report the resulting conflicts, without applying the merge."

Add the natural trigger phrase users most often say for this need — "merge conflicts" — e.g. "Use when checking merge conflicts before merging, or when reviewing overlapping branch or parallel-agent changes."

Mention the per-file preview capability in the description to further distinguish the skill from generic merge tooling.

DimensionReasoningScore

Specificity

It names the domain and one concrete action — "Preview how a named branch would merge into HEAD using the locally installed Weave CLI, without applying the merge" — but offers no second capability (e.g., reporting conflicts or per-file previews), fitting the "1-2 concrete actions, but not comprehensive" anchor rather than anchor 4's "several specific actions".

3 / 5

Completeness

It explicitly answers both what ("Preview how a named branch would merge into HEAD using the locally installed Weave CLI, without applying the merge") and when ("Use when reviewing overlapping branch or parallel-agent changes") with a concrete trigger phrase, matching anchor 5; not 4 because the "when" clause is explicit and specific, not merely present.

5 / 5

Trigger Term Quality

Natural terms are present ("preview", "merge", "branch", "HEAD", "overlapping branch or parallel-agent changes"), but the phrase users most commonly say for this need — "merge conflicts" — is absent, leaving "a few natural terms missing" (anchor 4) rather than anchor 5's comprehensive synonym coverage; not 3 because core keyword coverage is solid.

4 / 5

Distinctiveness Conflict Risk

The Weave-specific, read-only framing ("without applying the merge") carves a mostly distinct niche, but the trigger "reviewing overlapping branch or parallel-agent changes" could also fire review-type skills, giving "minor overlap risk with closely related skills" (anchor 4) rather than anchor 5's minimal conflict risk.

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

Ataraxy-Labs/sem

Path

integrations/agent-plugin/skills/weave-merge-preview/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.