create-backport-branch

Cherry-pick GitHub PR commits onto a target release branch with git cherry-pick -x.

12.4k|780|Updated Nov 2, 2020
One-click install
npx skills add https://github.com/redpanda-data/redpanda --skill create-backport-branch
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: create-backport-branch
Source: https://github.com/redpanda-data/redpanda/tree/main/.claude/skills/create-backport-branch
Command: npx skills add https://github.com/redpanda-data/redpanda --skill create-backport-branch

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Cherry-picking changes from a GitHub PR onto a target release branch to create a traceable backport branch, enabling stable bugfixes and feature backports without manual, error-prone workflows.

Core Features & Use Cases

  • Create a backport branch with the ai-backport- prefix to clearly identify the backport scope and source PR.
  • Cherry-pick all commits from the PR onto the target branch, track progress, and report outcomes including conflicts, skips, and touched files.
  • Use cases include backporting fixes to release branches (e.g., v25.1.x, v25.2.x) or backporting changes from dev/main to a versioned branch.

Quick Start

Provide the TARGET release branch or commit and the PR number to initiate the backport; the system will create the backport branch and perform the cherry-picks automatically.

Frequently Asked Questions about create-backport-branch

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I backport a pull request to an older release branch in git?

To backport a pull request, you cherry-pick all commits from the source PR onto a target release branch. This Skill automates that process by creating a dedicated branch and applying the changes using git cherry-pick -x to maintain a traceable record.

What is the safest way to cherry-pick commits from dev to a version branch?

The safest way to cherry-pick commits is using an automated workflow with built-in guardrails. This Skill applies commits with git cherry-pick -x and safely aborts on uncertain conflicts, reporting outcomes like skipped files or touched files to prevent error-prone manual merges.

How do I start cherry-picking a GitHub PR onto a specific target commit?

To start cherry-picking, provide the TARGET release branch or commit and the PR_NUM. The system uses these two arguments to automatically create a backport branch with an ai-backport- prefix and applies the changes from the specified PR.

Can I use git cherry-pick to backport multiple commits from a single PR?

Yes, you can use git cherry-pick to backport multiple commits from a single PR. The Skill automatically cherry-picks all commits from the provided PR number onto the target branch, tracking progress and reporting detailed outcomes for each commit.

What happens when a cherry-pick encounters a conflict during a PR backport?

When a cherry-pick encounters a conflict during a PR backport, the process safely aborts to avoid uncertain merges. The Skill reports the conflict outcomes, including any skipped or touched files, leaving the repository in a safe state for manual resolution.

Why should I use an automated backport branch instead of manual cherry-picking?

An automated backport branch prevents error-prone manual workflows by creating a traceable branch name with the ai-backport- prefix. It applies git cherry-pick -x to record source commits, ensuring stable bugfixes and clear identification of the backport scope and origin PR.