Create Pull Request

Overview

Creates GitHub pull requests with properly formatted titles using the project's PR template.

Before creating a PR, staged changes must be committed first using the git-commit skill.

Note: Do not add "Co-Authored-By", "Generated with" or any AI model references unless explicitly instructed by the user.

Workflow

Step 1: Check for staged changes

If there are staged changes, use the git-commit skill to commit them first:

git status

If staged changes exist, invoke the git-commit skill.

Step 2: Analyze current branch state

Run these commands to understand the changes:

git status
git diff --stat
git log origin/master..HEAD --oneline

Note: The base branch may be main or master - check which exists.

Step 3: Determine PR title

Analyze the commits to create a properly formatted PR title:

• Use imperative present tense: "Add" not "Added"
• Capitalize the first letter
• No period at the end
• No ticket IDs (e.g., MGX-1234)

Examples:

• "Add user authentication flow"
• "Fix memory leak in worker process"
• "Update API endpoint documentation"

Step 4: Push changes

Push the current branch to origin. Do not use --force. If the push fails, stop and return control to the user.

git push -u origin HEAD

Step 5: Create PR using gh CLI

Check if a PR template exists at .github/pull_request_template.md or .github/PULL_REQUEST_TEMPLATE.md.

If a template exists, read it and use it as the PR body.

Create the PR:

gh pr create --title "<PR_TITLE>" --body "<PR_BODY>"

If no template exists, create a PR with a basic body summarizing the changes.