pr

Automates GitHub pull requests from fork to submission with DCO sign-off.

10|1|Updated Aug 25, 2025
One-click install
npx skills add https://github.com/yanmxa/cc-plugins --skill pr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pr
Source: https://github.com/yanmxa/cc-plugins/tree/main/plugins/git/skills/pr
Command: npx skills add https://github.com/yanmxa/cc-plugins --skill pr

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires gh, git, and includes scripts (resource) components.

What problem does it solve?

This Skill eliminates the complex, multi-step, and often error-prone process of contributing to open-source projects or external repositories. It automates everything from forking and setting up your local environment to committing changes and submitting a pull request, saving developers significant time and reducing mental overhead.

Core Features & Use Cases

  • End-to-End PR Automation: Handles repository forking, cloning, branch creation, auto-commits, and pull request submission.
  • Idempotent & Safe: Designed to be re-run safely, detecting existing forks, clones, and PRs to avoid duplicate work.
  • Smart Remote Management: Automatically sets up upstream (original) and origin (your fork) remotes, even handling fork name mismatches.
  • Fast Setup: Utilizes shallow cloning for significantly faster repository setup.
  • Use Case: A developer needs to contribute a bug fix to an upstream repository. Instead of manually performing all Git operations, they can use this skill to automate the entire contribution workflow, focusing solely on writing the code fix.

Quick Start

Use the pr skill to create a pull request to the 'stolostron/multicluster-global-hub' repository. Base the PR on the 'main' branch, create a new feature branch named 'docs/fix-version', and title the pull request "docs: update version from 2.9 to 2.15".

Frequently Asked Questions about pr

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

FAQPage Schema
How do I automate creating pull requests to upstream repositories?

Automate pull request creation by using this Skill to fork a repository, clone it locally, create a feature branch, commit changes with DCO sign-off, and submit the PR to upstream—all in one workflow. It handles remote setup, detects existing PRs to avoid duplicates, and returns the PR URL upon success.

Can I contribute to open-source projects without manually running multiple Git commands?

Yes. This Skill eliminates manual Git operations by automating forking, cloning with shallow copies for speed, branch creation, committing, pushing to your fork, and opening a pull request. You focus on code changes while the Skill handles repository setup and submission.

What do I need to set up before automating pull requests with GitHub CLI?

Configure your Git user name and email, set up SSH keys for authentication, and have GitHub CLI (gh) and Git installed. The Skill requires proper remote configuration (upstream for the original repo, origin for your fork) and DCO sign-off capability in your Git environment.

Is it safe to re-run pull request automation without duplicating work?

Yes. The Skill is idempotent—it detects existing forks, clones, and pull requests, so re-running it safely skips duplicate steps. This prevents accidental duplicate PRs and lets you safely retry if the workflow is interrupted.

How does this approach handle fork name mismatches and remote configuration?

The Skill automatically sets up upstream and origin remotes even when fork names differ from the original repository. Smart remote management ensures correct tracking of both your fork and the upstream repository, avoiding manual remote reconfiguration.