CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

merge-batch

Prepare and merge an owner-selected PR batch with contributor credit and exact-candidate admission. Use for a pasted PR list; combined focused validation is diagnostic, and every actual landing still requires its applicable checks and authorization.

Quality

81%

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

77%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 disciplined, token-efficient gate protocol with excellent sequencing and per-phase validation checkpoints that fully cover the batch-merge risk profile. Its main weaknesses are execution-level detail (few runnable commands; most steps are stated as outcomes rather than operations) and a progressive-disclosure design that leans on shared files that are not present in the skill's bundle.

Suggestions

Add the concrete commands for the recurring operations (e.g. the gh/git commands to 'resolve each selected PR's open/draft state, current head/base' and the exact 'applicable static profile' invocations), or point to the specific shared file section that defines them.

Ship or verify the referenced files inside the skill bundle: `../_shared/base-green.md`, `../_shared/validation-gate.md`, `../_shared/merge-gates.md`, and `scripts/quality/check-skill-contract.mjs` currently do not exist relative to this SKILL.md, so the delegated protocol cannot actually be loaded.

Include a brief filled-in example of the '1–5 star table with rationale, overlaps and holds' so the intake artifact has a concrete shape rather than only a description.

DimensionReasoningScore

Conciseness

The body is lean and imperative throughout — e.g. "Pin the approved live base and record the ordered PR heads", "Keep stdout/stderr, exits, signals, versions and identities", "never use git stash" — with zero padding and no explanation of concepts Claude already knows. Every line states a rule or constraint, matching the 'every token earns its place' anchor; it is not the level-4 case because there are no over-explanations to trim.

5 / 5

Actionability

Some concrete guidance exists — "Run `scripts/quality/check-skill-contract.mjs`", "one owned branch and worktree under `.claude/worktrees/`", "`gh pr merge --match-head-commit` guards the head only" — but most steps stop short of executable detail ("Resolve each selected PR's open/draft state" and "Run the applicable static profile" name no commands), so key execution details are missing. It is above level 2 (it is more than high-level hints: specific paths, flags, and artifacts are given) but below level 4 because the majority of operations lack concrete commands or examples.

3 / 5

Workflow Clarity

Five explicitly sequenced phases each end with a validation checkpoint ("Completion: selected scope, target, ownership and permitted actions are explicit") and error-recovery feedback loops are pervasive: "A changed identity returns the item to validation", "a later PASS does not erase an earlier required FAIL", and section 5's re-validation of the resulting base before the next landing. This satisfies the batch-operation validation requirement and matches the anchor with explicit validation steps, feedback loops, and checklists; no minor gaps are evident.

5 / 5

Progressive Disclosure

The body opens by delegating to clearly signaled references ("Read `../_shared/base-green.md`, `../_shared/validation-gate.md` and `../_shared/merge-gates.md`") and sections are well organized, but none of the referenced files exist in this skill's bundle — there is no `references/`, `scripts/`, or `assets/` directory, and `scripts/quality/check-skill-contract.mjs` plus the `../_shared/` files resolve outside the skill and cannot be verified. This falls short of level 4 ('minor organization gaps') because the skill's core protocol depends on dangling, unverifiable paths, yet stays above level 2 because references are explicit and the inline content is structured.

3 / 5

Total

16

/

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 strong description that explicitly answers both what the skill does and when to use it, with a distinctive pasted-PR-list trigger and correct third-person imperative voice. Its only gaps are modest: a thin set of distinct concrete actions in the first sentence and some missing natural keyword variations.

DimensionReasoningScore

Specificity

The description names the domain and its core actions — "Prepare and merge an owner-selected PR batch" — but "with contributor credit and exact-candidate admission" reads as constraints/qualifiers rather than additional actions, leaving roughly two concrete actions total. This matches 'names domain and 1-2 concrete actions, but not comprehensive'; it is below level 4 ('lists several specific actions') because the second sentence adds caveats rather than more actions.

3 / 5

Completeness

Both questions are answered explicitly: the 'what' is "Prepare and merge an owner-selected PR batch with contributor credit and exact-candidate admission" and the 'when' is the concrete trigger "Use for a pasted PR list". This matches the anchor 'clearly and explicitly answers both what AND when with concrete trigger phrases'; it exceeds level 4 because the when-clause is explicit and specific, not merely implied or generic.

5 / 5

Trigger Term Quality

Natural trigger vocabulary is present: "merge", "PR batch", "pasted PR list", and "landing" — phrases a user asking for this skill would plausibly say ("merge this batch of PRs"). Coverage is good but a few natural terms are missing ("pull request" spelled out, "batch merge", "land these PRs"), so it sits at level 4 rather than the comprehensive synonym/extension coverage of level 5.

4 / 5

Distinctiveness Conflict Risk

The niche is clear and the trigger ("Use for a pasted PR list", "owner-selected PR batch") is distinctive, with explicit scope limits ("every actual landing still requires its applicable checks and authorization") separating it from blanket-merge behavior. However, shared PR/merge/check vocabulary creates minor overlap risk with closely related single-PR merge or validation skills (the body's references to a `../_shared/` protocol family suggest siblings), so it does not reach 'minimal conflict risk' at level 5.

4 / 5

Total

16

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

referenced_paths_exist

Referenced path issues: 1 missing, 1 deeper-than-1-level

Warning

Total

14

/

16

Passed

Repository

diegosouzapw/OmniRoute

Path

config/quality/skill-templates/merge-batch/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.