Claude Code Plugins

Community-maintained marketplace

Feedback

github-pr

@jroslaniec/agent-skills
1
0

Create GitHub pull requests using gh CLI with automatic stacked PR detection. Use when the user asks to create a PR, open a pull request, make a PR, or mentions creating/opening a pull request on GitHub.

Install Skill

1Download skill
2Enable skills in Claude

Open claude.ai/settings/capabilities and find the "Skills" section

3Upload to Claude

Click "Upload skill" and select the downloaded ZIP file

Note: Please verify skill by going through its instructions before using it.

SKILL.md

name github-pr
description Create GitHub pull requests using gh CLI with automatic stacked PR detection. Use when the user asks to create a PR, open a pull request, make a PR, or mentions creating/opening a pull request on GitHub.

GitHub Pull Request

Create pull requests using GitHub CLI with stacked PR detection.

Instructions

Step 1: Gather Context

Run the skill's context-gathering script from the repository root:

scripts/gather-pr-context.sh

The script outputs the current working directory first. Verify you are in the correct repository before proceeding.

Step 2: Analyze Context

From the script output, determine:

Stacked vs Normal PR:

  • Parse git log --oneline --decorate for branch refs in parentheses
  • First branch NOT current and NOT main/origin/main = parent branch
  • Parent is main → Normal PR
  • Parent is other branch → Stacked PR

Push status:

  • git log origin/<branch>..HEAD empty → pushed ✓
  • Shows commits → need to push first

Existing PR:

  • gh pr list returns data → PR exists, offer to update
  • Empty → create new PR

Step 3: Push if Needed

git push -u origin HEAD

Step 4: Create PR

Normal PR:

gh pr create --draft --base main --title "title" --body "body"

Stacked PR:

gh pr create --draft --base <parent-branch> --title "title" --body "body"

Guidelines:

  • Use ticket number from branch name as title prefix (e.g., PAT-123)
  • Keep description short and proportional to changes
  • For stacked PRs, describe only THIS branch's changes
  • Create in draft mode unless explicitly requested otherwise

Step 5: Output

Normal PR:

Created PR
* Merge : `<branch>` into `main`
* PR URL: <url>

Stacked PR:

📚 Stacked PR 📚
* Merge    : `<branch>` into `<parent>`
* New PR   : <url>
* Parent PR: <parent-url or "⚠️ No Parent PR">

Rules

  • NEVER include attribution markers in PR titles or descriptions. This includes but is not limited to:
    • "Co-Authored-By" or "Co-authored-by" headers
    • "Generated by", "Created by", "Written by" followed by any AI/LLM name
    • Footers like "🤖 Generated with Claude Code" or similar
    • Any mention of AI tools: Claude, GPT, Copilot, Codex, Gemini, Cursor, or other LLMs/assistants
    • Any text or links indicating AI involvement in creating the PR

Requirements

  • GitHub CLI (gh) installed and authenticated
  • Git remote configured
  • Push access to repository