CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

backport-pr

Backport a merged Next.js pull request from canary to an LTS release branch (releases/lts/active or releases/lts/maintenance). Use when the user asks to backport, cherry-pick, or open a backport PR from a PR number to an older Next.js version. Covers finding the merged PR commit, creating a backport branch from the target release branch, cherry-picking from canary, validating, and opening the PR with the release branch as the base.

Quality

92%

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

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.

A tight, executable procedure document: every step carries a concrete command, non-obvious constraints are captured, and validation/feedback loops are present at the risky points (branch switching, commit identification, empty cherry-picks). The only soft spot is the under-specified verification commands in step 6.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence with git/gh/pnpm, spending its tokens only on non-obvious repo knowledge (the build-all exception, `-x` for provenance, the LTS branch selection policy, empty-cherry-pick handling); no sections explain concepts Claude already knows, fitting the 'every token earns its place' anchor.

5 / 5

Actionability

Steps 1–5, 7, and the PR templates are copy-paste ready with clearly marked placeholders (<pr-number>, <target-branch>), but step 6's verification guidance ("the relevant integration test mode for behavior changes") leaves the actual Next.js test commands unspecified — a minor gap consistent with the score-4 anchor rather than full coverage of the common cases.

4 / 5

Workflow Clarity

Seven clearly sequenced steps include explicit validation checkpoints — pre-flight `git status`/branch inspection, cross-checking mergeCommit against `git log --grep` with subject verification, a conflict-resolution policy, an empty-cherry-pick feedback loop (verify already-present and report instead of duplicating), and a dedicated verification step — matching the score-5 anchor with error-recovery loops.

5 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are absent) and none are needed: this single-purpose skill is well organized into Inputs / Workflow / PR Shape / Related Skills sections, with clearly signaled one-level pointers to related skills ($create-pr, $pr-status-triage) and no content wrongly inlined.

5 / 5

Total

19

/

20

Passed

Description

92%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: it states a precise, multi-action capability set and an explicit 'Use when' trigger clause with natural user phrasing, all in third person with no fluff or over-claims. The only improvement space is broader trigger synonym coverage.

DimensionReasoningScore

Specificity

The description enumerates five concrete actions — "finding the merged PR commit", "creating a backport branch from the target release branch", "cherry-picking from canary", "validating", and "opening the PR with the release branch as the base" — giving comprehensive coverage of the workflow, matching the score-5 anchor rather than the score-4 anchor, which allows for coverage gaps.

5 / 5

Completeness

It explicitly answers 'what' ("Covers finding the merged PR commit, creating a backport branch... cherry-picking from canary, validating, and opening the PR") and 'when' ("Use when the user asks to backport, cherry-pick, or open a backport PR from a PR number to an older Next.js version") with concrete trigger phrases, matching the score-5 anchor exactly.

5 / 5

Trigger Term Quality

"Use when the user asks to backport, cherry-pick, or open a backport PR from a PR number" supplies the natural phrases a user would say, but variants like "back-port" or "apply a fix to the release branch" are absent, fitting the 'good keyword coverage; a few natural terms missing' anchor rather than comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

It carves out a clear niche — backporting merged Next.js PRs from canary to named LTS branches (releases/lts/active, releases/lts/maintenance) — with triggers unlikely to fire for generic PR-creation or cherry-pick help, so conflict risk is minimal.

5 / 5

Total

19

/

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

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

Total

14

/

16

Passed

Repository

vercel/next.js

Path

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