mp-gh-issue-branch-pr

Convert local changes into a GitHub issue, branch, and draft PR.

1|Updated Feb 7, 2026
One-click install
npx skills add https://github.com/MartinoPolo/mpx-claude-code --skill mp-gh-issue-branch-pr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mp-gh-issue-branch-pr
Source: https://github.com/MartinoPolo/mpx-claude-code/tree/main/_archive/skills-deprecated/mp-gh-issue-branch-pr
Command: npx skills add https://github.com/MartinoPolo/mpx-claude-code --skill mp-gh-issue-branch-pr

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It streamlines turning your current local changes into a properly labeled GitHub issue, a matching branch, and a conventional-commit PR workflow so you can log work and collaborate faster.

Core Features & Use Cases

  • Issue-first workflow: Captures current context (status/diffs), drafts a GitHub issue, and applies existing repository labels (bug/feature/chore/docs) without creating new labels.
  • Branch + commit automation: Derives a branch name from issue metadata, creates/switches to the branch, stages specific files, and creates a conventional commit aligned with repo style.
  • PR creation/update with linkage: Detects the base branch, finds/extracts the issue number, adds Resolves/Closes linkage, and creates or updates a draft PR as needed.

Quick Start

Ask the AI to run mp-gh-issue-branch-pr to create a labeled GitHub issue from your current changes, create a branch from the issue number, commit the work, push it, and open or update a draft PR.

Frequently Asked Questions about mp-gh-issue-branch-pr

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

FAQPage Schema
How do I convert local uncommitted changes into a GitHub issue and draft PR?

To convert local changes into a GitHub issue and draft PR, this Skill captures your current Git status and diffs to draft a labeled issue, creates a matching branch, commits using conventional commits, and opens a draft PR with Closes linkage. It automates the entire issue-first workflow.

Can I create an issue-driven branch and pull request using existing repository labels?

Yes, you can create an issue-driven branch and pull request using existing repository labels. The workflow matches your current changes to existing labels like bug, feature, chore, or docs without creating new labels, ensuring the generated issue and PR align with your repository's established categorization.

What is the best way to automate conventional commits and GitHub PR linkage from local work?

The best way to automate conventional commits and GitHub PR linkage is using an issue-first workflow that stages specific files, commits with conventional format, detects the base branch, and adds Resolves or Closes linkage to a draft PR, ensuring proper traceability from issue to merge.

Does this workflow require the gh CLI to create branches and pull requests?

Yes, this workflow requires the gh CLI to create branches and pull requests. The process relies on Git commands and gh CLI usage to capture local context, create the GitHub issue, push the derived branch, and establish the draft PR with proper issue linkage.

Why does my automated pull request need a Closes linkage to a GitHub issue?

Your automated pull request needs a Closes linkage to a GitHub issue to automatically close the issue upon merging. This issue-driven workflow extracts the issue number from the branch metadata and injects the linkage into the draft PR description, maintaining clean project tracking.

How to handle base branch detection when creating a draft PR from a new feature branch?

To handle base branch detection when creating a draft PR, the workflow automatically identifies the appropriate base branch in your repository. It then creates or updates the draft PR targeting that branch, ensuring your conventional commit changes merge into the correct integration line.