CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

pr-merge

Merge the current branch's PR after confirmation

Quality

71%

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

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/pr-merge/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

This is a strong, execution-ready skill: fully specified gh/git commands, a clear six-step sequence, explicit blocker checks, and a user-confirmation gate before the destructive merge. Remaining improvements are small — trimming minor over-explanations, fixing the duplicated heading, and adding failure handling for the merge step itself.

Suggestions

Remove or relocate the duplicated "# Merge PR" H1 nested under "## Command Template" so the document has a single heading hierarchy.

Drop the sentence explaining "git pull --prune" (Claude already knows this flag) and the re-statement of the method choices in step 4.

Add brief failure handling for the merge step, e.g., if "gh pr merge" fails or the chosen method is disabled, re-run "gh pr view" and report the new state to the user.

DimensionReasoningScore

Conciseness

The body is efficient — commands and templates dominate — but has minor over-explanation: the trailing sentence explaining what "git pull --prune" does and re-stating that <method> is squash/rebase/merge when the options were already enumerated in step 3. These are trimmable without loss, so anchor 4 rather than the every-token-earns-its-place anchor 5.

4 / 5

Actionability

The "gh pr view" command with its full --jq filter and the cleanup commands are copy-paste ready, and the merge command's <number>/<method> placeholders are concretely sourced from earlier steps. Minor gaps keep it from a 5: no guidance if the chosen merge method is disabled on the repo or the merge command itself fails.

4 / 5

Workflow Clarity

Six steps are clearly sequenced with real validation checkpoints for a destructive operation: stop if no PR exists, report blockers (CI, reviews, conflicts) and stop, and a user confirmation gate with an explicit cancel option before merging. It falls short of anchor 5 because there is no error-recovery loop after a failed merge attempt (e.g., re-checking mergeable state or retry guidance).

4 / 5

Progressive Disclosure

Sections are well-organized and all content is appropriately inline for a skill of this size with no external references needed (no references/, scripts/, or assets/ directories exist, and the body cites none). The duplicated nested "# Merge PR" H1 under "## Command Template" is a structural oddity that mildly hurts navigation, keeping this at anchor 4 rather than 5.

4 / 5

Total

16

/

20

Passed

Description

53%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 states a single clear, concrete action with a confirmation guardrail, but it has no trigger guidance at all and omits the supporting actions the skill performs (CI/review checks, merge method choice, branch cleanup). Practically, the missing triggers matter less since the frontmatter sets disable-model-invocation: true, meaning the skill is invoked by name rather than discovered via description, but the description text itself remains thin.

Suggestions

Add an explicit trigger clause, e.g. "Use when the user asks to merge, land, or close out the pull request for the current branch."

Include the synonym "pull request" alongside "PR" so the natural phrasing users actually say is covered.

Briefly enumerate the supporting actions to raise specificity, e.g. "Check CI and review status, confirm the merge method with the user, merge the current branch's PR, and clean up the local branch."

DimensionReasoningScore

Specificity

"Merge the current branch's PR" is one concrete action with a clear target and the guardrail "after confirmation", matching the anchor for 1-2 concrete actions that are not comprehensive. It does not list the other actions the body actually performs (readiness checks, merge method selection, branch cleanup), so it is not a 4.

3 / 5

Completeness

The "what" is clear (merge the current branch's PR), but there is no "Use when..." clause or any trigger guidance, so completeness is capped at 3 per the judging guidelines. It is not a 2 because the "what" is specific rather than vague, and not a 4 because the "when" is entirely absent rather than weakly implied.

3 / 5

Trigger Term Quality

"Merge" and "PR" are the natural terms a user would say for this task, but the description omits common variations like "pull request" spelled out or "land the PR". Coverage of relevant keywords exists yet synonyms are missing, which matches anchor 3 rather than the broader coverage of anchor 4.

3 / 5

Distinctiveness Conflict Risk

PR merging is a distinct niche with concrete, specific triggers; only minor overlap risk exists with closely related GitHub PR skills (e.g., PR creation or review skills). It lacks the explicit distinct trigger phrases of anchor 5, but is far more specific than the broad overlap examples of anchor 3.

4 / 5

Total

13

/

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

phatblat/dotfiles

Path

.agents/skills/pr-merge/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.